Skip to content

README.md

Latest commit

 

History

History
96 lines (71 loc) · 4.1 KB

README.md

File metadata and controls

96 lines (71 loc) · 4.1 KB

🚀 TikDrop (tikdrop.my.id)

Next.js TypeScript Tailwind CSS License: MIT

TikDrop is a high-performance, production-ready Progressive Web Application (PWA) designed for seamless TikTok content extraction. Built with the latest Next.js 16 and GenKit AI, it provides a premium user experience for downloading TikTok videos in HD, high-quality audio (MP3), or image slides without watermarks.

✨ Core Features

  • 🛡️ Watermark-Free Downloads: Precise extraction of TikTok video streams (MP4) and audio (MP3).
  • 📦 Image Slides to ZIP: Unique capability to parse TikTok photo slides and package them into a single .zip file.
  • 📱 Native PWA Experience: Fully installable on iOS, Android, and Desktop with offline support and optimized performance.
  • 💰 Integrated Monetization: Smart Google AdSense hooks with ad-gated download modals.
  • 🌍 Multi-Language Support: Full localization for English (en) and Indonesian (id).
  • ♿ WCAG Accessibility: Advanced accessibility widget (High Contrast, Large Text, Link Highlighting).
  • 🔒 Secure Auth & History: Synchronized user activity using Firebase Auth and Firestore.
  • 🤖 AI-Powered Content: Integrated with Google GenKit for intelligent background processing and content generation.

🛠️ Tech Stack

📂 Project Structure

src/
├── app/            # Next.js App Router (Pages & API)
├── components/     # Reusable UI components (Shadcn + Custom)
├── ai/             # GenKit AI flows and logic
├── lib/            # Utilities, Firebase config, and shared logic
├── hooks/          # Custom React hooks
├── locales/        # i18n translation files
└── scripts/        # Build and maintenance scripts

🚀 Getting Started

1. Prerequisites

  • Node.js 20.x or higher
  • A Firebase Project
  • Google Gemini API Key (for AI features)

2. Installation

git clone https://github.com/mikeu-dev/tiktok-adgate.git
cd tiktok-adgate
npm install

3. Environment Setup

Create a .env.local file based on .env.example:

cp .env.example .env.local

Fill in your Firebase credentials and API keys.

4. Run Development Server

npm run dev

Open http://localhost:9002 to view the app.

📄 Documentation

Detailed guides are available in the docs/ directory:

  • 🗺️ Blueprint: Technical architecture and style guidelines.
  • 🔍 SEO Guide: Steps for Google Search Console and SEO optimization.
  • 🤝 Contributing: How to contribute to this project.

🛡️ Legal & License

Distributed under the MIT License. See LICENSE for more information.

Disclaimer: This project is an independent tool and is NOT AFFILIATED with TikTok, ByteDance, or any of their corporate entities. Users are responsible for ensuring they have the right to download and use the content.

Built with ❤️ by mikeu-dev