Skip to content

felipebasurto/viralslide

Repository files navigation

ViralSlide 🔥

AI-Powered TikTok Slideshow Generator

Create scroll-stopping, viral TikTok content with proven formats and AI-generated hooks that drive engagement.

✨ Features

  • 🤖 AI Content Generation: Powered by Deepseek AI to create compelling slideshow content
  • 📊 Multiple Viral Formats: Top 5 Tips, Common Errors, Recommendations, Before/After, and more
  • 🌍 Multi-Language Support: Generate content in English and Spanish
  • 📈 Simple Content Tracking: Manually track your TikTok videos' performance metrics
  • 🎨 Custom Formats: Create your own unique viral content formats
  • 💡 Smart Optimization: Get suggestions for visual content and engagement strategies
  • 📱 Responsive Design: Beautiful, modern UI that works on all devices

🛠️ Tech Stack

  • Frontend: React 18 + TypeScript
  • Build Tool: Vite
  • Styling: Tailwind CSS
  • UI Components: shadcn/ui
  • Routing: React Router DOM
  • Forms: React Hook Form + Zod validation
  • AI Integration: Deepseek API
  • State Management: React hooks + localStorage

🚀 Quick Start

Prerequisites

Installation

  1. Clone the repository

    git clone <your-repo-url>
    cd viralslide
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev
  4. Open your browser Navigate to http://localhost:8080

Configuration

  1. Go to Settings in the app
  2. Enter your Deepseek API key
  3. Add your business information for personalized content
  4. Start generating viral content!

📖 Usage

Generating Content

  1. Choose a Format: Select from proven viral formats like "Top 5 Tips" or "Common Errors"
  2. Enter Your Topic: Describe what you want to create content about
  3. Select Language: Choose English or Spanish
  4. Generate: Let AI create your viral slideshow content
  5. Copy & Use: Copy the generated content for your TikTok videos

Tracking Performance

  1. Add TikTok URLs: Paste your TikTok video links in the Content Tracker
  2. Manual Input: Easily update metrics by clicking the edit button on any content
  3. Track Progress: Monitor views, likes, comments, and shares over time
  4. Analyze Performance: See which content formats perform best with engagement calculations

🎯 Viral Formats Available

  • Top 5 Tips: Share your best advice in your niche
  • Common Errors: Highlight mistakes people make
  • Recommendations: Suggest tools, products, or strategies
  • Before vs After: Show transformations or improvements
  • Myths vs Facts: Debunk common misconceptions
  • Beginner's Guide: Essential steps for newcomers
  • Custom Format: Create your own unique viral format

📁 Project Structure

viralslide/
├── src/
│   ├── components/          # Reusable UI components
│   │   ├── ui/             # shadcn/ui components
│   │   └── ContentResult.tsx
│   ├── hooks/              # Custom React hooks
│   ├── lib/                # Utility functions
│   ├── pages/              # Route components
│   │   ├── Index.tsx       # Landing page
│   │   ├── Generate.tsx    # Content generation
│   │   ├── Dashboard.tsx   # Content tracking
│   │   └── Settings.tsx    # Configuration
│   ├── App.tsx             # Main app component
│   └── main.tsx            # App entry point
├── public/                 # Static assets
└── package.json           # Dependencies and scripts

🔧 Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run build:dev - Build in development mode
  • npm run lint - Run ESLint
  • npm run preview - Preview production build

🌟 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Support

If you have any questions or need help:

  • Open an issue on GitHub
  • Check the documentation
  • Review the code examples in the project

🎉 Acknowledgments


Made with ❤️ for content creators who want to go viral on TikTok

About

Super useful tool i made in two afternoons using Lovable to help me create viral TikToks! Polished using Cursor

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages