🪄 DocMagic - AI Document Creation Platform

🚀 Transform Ideas into Professional Documents with AI Magic

DocMagic is a 100% open source, cutting-edge AI-powered document creation platform that revolutionizes how professionals create stunning documents. Built by the community, for the community - simply describe what you need, and watch as our advanced AI transforms your ideas into polished resumes, captivating presentations, comprehensive CVs, and professional letters in seconds.

🎯 50,000+ Documents Created • 🏆 99% Success Rate • ⭐ 4.9/5 User Rating • 🌍 50+ Countries

"Create professional documents in seconds with AI magic ✨"

✨ Core Features & Capabilities

🤖 AI-Powered Document Generation

🎯 Smart Resume Builder: Create professional resumes with Gemini AI 2.0 Flash and 9-step guided workflow
📊 Presentation Generator: Generate complete slide decks with outlines, themes, and shareable public URLs
🔗 Presentation Sharing: Share presentations via public URLs with privacy controls and anonymous viewing
📄 CV Creator: Build comprehensive curriculum vitae with intelligent formatting
✉️ Letter Composer: Draft professional letters for any purpose
🔍 ATS Resume Analyzer: Advanced ATS compatibility scoring with detailed optimization feedback
🎨 Professional Templates: ATS-optimized templates with modern glass morphism design
📈 Progress Tracking: Visual progress indicators and step-by-step completion tracking

🎨 Modern UI/UX Design

✨ Glass Morphism Interface: Modern glass-effect components with subtle transparency and blur effects
🌈 Gradient Magic: Dynamic bolt gradients and shimmer effects throughout the interface
🎭 Floating Animations: Smooth floating orbs and animated background elements powered by Framer Motion
📱 Responsive Excellence: Mobile-first design optimized for all screen sizes
🌙 Dark/Light Theme: Seamless theme switching with next-themes
♿ Accessibility First: WCAG 2.1 AA compliant components
🎯 Magical Professionalism: Design philosophy combining cutting-edge visual effects with professional usability
Micro-Interactions: Hover effects, scale transitions, and pulse animations for enhanced user engagement

🤖 AI-Powered Document Generation

Smart Text Processing: Advanced Gemini AI integration for intelligent content generation
Context-Aware Creation: AI understands industry standards and target audience requirements
Multiple Document Types:
- 📄 Professional Resumes with ATS optimization
- 🎯 Stunning Presentations with smart layouts, charts, and shareable public URLs
- 🔗 Shareable Presentations with privacy controls and anonymous viewing support
- 📋 Comprehensive CVs for academic and research positions
- ✉️ Business Letters with perfect tone and formatting

🛠️ Professional Tools & Features

Advanced ATS Analyzer: Comprehensive resume scanning with detailed scoring and optimization suggestions
Professional Template Library: Curated collection of ATS-optimized, modern templates with glass morphism design
Guided Resume Builder: 9-step workflow with progress tracking and intelligent navigation
Smart Editing: Intuitive WYSIWYG editor with real-time preview and mobile-first design
Enhanced Export Options: Download as PDF, DOCX, or PPTX with improved formatting and ATS compatibility
Presentation Sharing: Generate shareable public URLs with one-click sharing and privacy controls
Anonymous Viewing: Public presentations viewable without authentication for seamless sharing
Chart Integration: Automatic data visualization for presentations using Recharts
Mobile-Responsive Navigation: Touch-optimized interface that works perfectly on all devices
📄 Comprehensive About Page: Detailed information about features, technology, security, and roadmap accessible at /about
🧭 Intuitive Navigation: Clean header with easy access to Resume, Presentation, Letter tools, and About page
Image Integration: Professional stock photos from Pexels API

🛠️ Tech Stack & Architecture

🎨 Frontend Excellence

Next.js 15 - Latest React framework with App Router and Server Components
TypeScript 5.2 - Full type safety and enhanced developer experience
Tailwind CSS 3.3 - Utility-first styling with custom animations and gradients
Radix UI - Accessible, unstyled component primitives for maximum customization
Framer Motion 12 - Smooth animations and micro-interactions
Lucide React - 1000+ beautiful, customizable SVG icons
React Hook Form - Performant forms with validation
Zustand - Lightweight state management

🔧 Advanced Component System

🎨 Radix UI Foundation: 25+ accessible components including dialogs, dropdowns, and forms
📝 Form Management: React Hook Form with Zod validation for type-safe forms
📊 Data Visualization: Recharts integration for analytics and progress tracking
🎪 Interactive Elements: Carousels, accordions, and collapsible content
🎯 Smart Inputs: OTP inputs, date pickers, and file upload with drag-and-drop
🔔 Toast Notifications: Sonner-powered notifications for user feedback

🔐 Authentication & Security

🛡️ Supabase Auth: Secure user authentication with JWT tokens
👤 User Management: Registration, login, password reset, and profile management
🔒 Protected Routes: Client-side route protection and redirects
📊 Session Management: Persistent sessions with automatic token refresh
🔐 Environment Security: Secure API key management and environment variables

💳 Payment & Subscription System

💰 Stripe Integration: Secure payment processing with Stripe
📋 Subscription Management: Pro/Free tier management with usage limits
🏪 Customer Portal: Self-service billing and subscription management
📊 Usage Tracking: Monitor document generation limits and analytics
🔔 Webhook Handling: Real-time payment and subscription status updates
Glass Morphism Design: Custom CSS with backdrop-blur and transparency effects
Responsive Grid System: Mobile-first approach with breakpoint optimization
Custom Animations: Floating orbs, shimmer effects, and gradient transitions
Accessibility First: ARIA compliance and keyboard navigation support
Theme System: Dark/light mode with system preference detection

🗄️ Backend & Database

Supabase - PostgreSQL with real-time subscriptions and Row Level Security
Supabase Auth - OAuth providers, magic links, and secure session management
Database Migrations - Version-controlled schema changes
Real-time Updates - Live collaboration features

🤖 AI & External Services

Google Gemini AI - Advanced language model for intelligent content generation
Pexels API - Professional stock photography integration
Document Parsers - PDF, DOCX parsing with Mammoth.js and pdf-parse
Export Libraries - jsPDF, docx, and pptxgenjs for multi-format downloads

💳 Payments & Subscriptions

Stripe Integration - Secure payment processing with webhooks
Subscription Management - Tiered pricing with usage tracking
Customer Portal - Self-service billing and subscription management

🚀 Deployment & Performance

Netlify - Edge deployment with automatic builds and previews
Vercel Ready - Alternative deployment configuration included
Performance Optimized - Image optimization, code splitting, and caching strategies

🎨 UI/UX Design Philosophy

✨ Modern Glass Morphism Interface

DocMagic features a cutting-edge design system built around glass morphism principles, creating a sophisticated and intuitive user experience:

Glass Effects: Subtle transparency and backdrop-blur effects throughout the interface
Dynamic Gradients: Custom "bolt gradients" that create visual depth and energy
Floating Elements: Animated orbs and particles that respond to user interactions
Shimmer Animations: Subtle shine effects that guide user attention
Responsive Typography: Fluid text scaling that adapts to all screen sizes

🎯 User Experience Highlights

📱 Mobile-First Responsive Design

Optimized touch targets for mobile devices
Swipe gestures and touch-friendly interactions
Progressive enhancement for larger screens
Consistent experience across all devices

🌓 Intelligent Theme System

Automatic dark/light mode detection based on system preferences
Smooth theme transitions with preserved user state
High contrast ratios for accessibility compliance
Custom color schemes for different document types

⚡ Performance-Optimized Interactions

60fps animations using hardware acceleration
Lazy loading for optimal page speed
Debounced search and form inputs
Optimistic UI updates for instant feedback

📸 Platform Screenshots

🏠 Landing Page with Glass Morphism Design

Hero section with floating animations and gradient effects

📄 AI Resume Generator Interface

Intelligent resume builder with real-time ATS optimization

🎯 Presentation Studio with Smart Layouts

Professional slide creator with automatic chart generation

🏗️ Technical Architecture

🚀 Frontend Stack

// Core Framework
Next.js 15.4.0          // React framework with App Router
React 18.3.1            // UI library with concurrent features
TypeScript 5.8.3        // Type-safe development

// Styling & UI
Tailwind CSS 3.4.17     // Utility-first CSS framework
Radix UI                // Accessible component primitives
Framer Motion 12.23.6   // Animation library
next-themes 0.4.6       // Theme management

// Forms & Validation
React Hook Form 7.60.0  // Performant forms
Zod 3.25.76            // Schema validation

🔧 Backend & Services

// Database & Auth
Supabase                // PostgreSQL database + Auth
@supabase/auth-helpers-nextjs 0.10.0
@supabase/supabase-js 2.52.0

// AI & Generation
Google Gemini AI        // Document generation
@google/generative-ai 0.3.1 // Official Gemini SDK

// Payments
Stripe 14.25.0          // Payment processing
@stripe/stripe-js 3.5.0 // Client-side Stripe

// Document Processing
mammoth 1.9.1           // DOCX parsing
pdf-parse 1.1.1         // PDF parsing
docx 8.5.0              // DOCX generation
jspdf 2.5.2             // PDF generation
pptxgenjs 3.12.0        // PowerPoint generation

📊 Document Processing Pipeline

graph LR
    A[User Input] --> B[AI Processing]
    B --> C[Gemini AI 2.0]
    C --> D[Content Generation]
    D --> E[Template Application]
    E --> F[Export Options]
    F --> G[PDF/DOCX/PPTX]

🔍 ATS Analyzer System

Real-time resume analysis with actionable insights

📁 Project Structure

docmagic/
├── app/                      # Next.js app directory
│   ├── api/                  # API routes
│   │   ├── analyze/          # Resume analysis endpoints
│   │   ├── auth/             # Authentication endpoints
│   │   ├── generate/         # Document generation endpoints
│   │   ├── send-email/       # Email sending functionality
│   │   ├── stripe/           # Stripe payment integration
│   │   └── user/             # User data endpoints
│   ├── auth/                 # Authentication pages
│   ├── cv/                   # CV generator page
│   ├── letter/               # Letter generator page
│   ├── presentation/         # Presentation generator page
│   ├── resume/               # Resume generator pages
│   ├── settings/             # User settings page
│   ├── globals.css           # Global styles
│   ├── layout.tsx            # Root layout component
│   └── page.tsx              # Home page
├── components/               # React components
│   ├── auth-provider.tsx     # Authentication context provider
│   ├── document-card.tsx     # Document type card component
│   ├── features-section.tsx  # Features showcase section
│   ├── hero-section.tsx      # Landing page hero section
│   ├── letter/               # Letter-specific components
│   ├── presentation/         # Presentation-specific components
│   ├── resume/               # Resume-specific components
│   ├── site-header.tsx       # Navigation header
│   ├── sponsor-banner.tsx    # Sponsor information banner
│   ├── subscription-button.tsx # Subscription management
│   ├── testimonials-section.tsx # User testimonials
│   ├── theme-provider.tsx    # Dark/light theme provider
│   ├── theme-toggle.tsx      # Theme toggle button
│   └── ui/                   # UI components (shadcn/ui)
├── hooks/                    # Custom React hooks
│   ├── use-subscription.ts   # Subscription state management
│   └── use-toast.ts          # Toast notifications
├── lib/                      # Utility libraries
│   ├── gemini.ts             # Google Gemini AI integration
│   ├── parsers/              # Document parsing utilities
│   ├── stripe.ts             # Stripe payment configuration
│   ├── supabase/             # Supabase client configuration
│   └── utils.ts              # General utility functions
├── public/                   # Static assets
├── supabase/                 # Supabase configuration
│   └── migrations/           # Database migration files
├── types/                    # TypeScript type definitions
│   └── supabase.ts           # Supabase database types
├── .env.local                # Environment variables (not in repo)
├── .eslintrc.json            # ESLint configuration
├── .gitignore                # Git ignore file
├── CONTRIBUTING.md           # Contribution guidelines
├── LICENSE                   # MIT license
├── README.md                 # Project documentation
├── middleware.ts             # Next.js middleware
├── netlify.toml              # Netlify deployment configuration
├── next.config.js            # Next.js configuration
├── package.json              # Project dependencies
├── postcss.config.js         # PostCSS configuration
├── tailwind.config.ts        # Tailwind CSS configuration
└── tsconfig.json             # TypeScript configuration

🚀 Quick Start Guide

🌐 Learn More

Visit our comprehensive About Page at https://docmagic1.netlify.app/about to explore:

🎯 Mission & Vision - Our commitment to democratizing document creation
⚡ Core Features - AI-powered tools and capabilities
🛠️ Technology Stack - Modern tech powering DocMagic
🎨 Design Philosophy - "Magical Professionalism" approach
🔒 Security & Quality - Enterprise-grade security measures
🗺️ Product Roadmap - Exciting features coming in 2025-2026
👥 Community - Join our open source community

📋 Prerequisites

Before you begin, ensure you have the following installed:

Node.js >= 18.0.0       # JavaScript runtime
npm >= 9.0.0            # Package manager
Git                     # Version control

⚡ One-Click Setup

# Clone the repository
git clone https://github.com/yourusername/docmagic.git
cd docmagic

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your API keys

# Run development server
npm run dev

🎉 That's it! Open http://localhost:3000 to see DocMagic in action.

🔧 Environment Configuration

Create a .env.local file in the root directory:

# Supabase Configuration
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# Google Gemini AI
GEMINI_API_KEY=your_gemini_api_key

# Stripe Configuration
STRIPE_SECRET_KEY=your_stripe_secret_key
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key
STRIPE_WEBHOOK_SECRET=your_webhook_secret

# Application URL
NEXT_PUBLIC_APP_URL=http://localhost:3000

🗄️ Database Setup

Create Supabase Project:

# Visit https://supabase.com/dashboard
# Create new project
# Copy your project URL and anon key

Run Migrations:

-- The migrations are in /supabase/migrations/
-- They will be automatically applied when you set up Supabase

Set up Authentication:

# Enable Email/Password auth in Supabase dashboard
# Configure email templates (optional)
# Set up OAuth providers (optional)

🤖 AI Service Setup

Get Gemini API Key:

# Visit https://ai.google.dev/
# Create API key
# Add to GEMINI_API_KEY in .env.local

Configure AI Models:

// lib/gemini.ts already configured with:
// - gemini-2.0-flash for fast generation
// - Error handling and retries
// - JSON parsing and validation

💳 Payment Setup (Optional)

Stripe Configuration:

# Visit https://dashboard.stripe.com/
# Get your API keys
# Set up webhook endpoint: /api/stripe/webhook

Webhook Events:

// Configure these events in Stripe dashboard:
customer.subscription.created
customer.subscription.updated
customer.subscription.deleted
invoice.payment_succeeded
invoice.payment_failed

🛠️ Development Commands

# Development
npm run dev          # Start development server
npm run build        # Build for production
npm run start        # Start production server
npm run lint         # Run ESLint
npm run type-check   # Run TypeScript checks

# Database
npx supabase start   # Start local Supabase
npx supabase stop    # Stop local Supabase
npx supabase reset   # Reset local database

# Deployment
npm run deploy       # Deploy to Netlify
vercel --prod        # Deploy to Vercel

📁 Project Structure

docmagic/
├── 📁 app/                    # Next.js App Router
│   ├── 📁 api/               # API routes
│   │   ├── 📁 generate/      # AI generation endpoints
│   │   ├── 📁 stripe/        # Payment webhooks
│   │   └── 📁 auth/          # Authentication
│   ├── 📁 resume/            # Resume pages
│   ├── 📁 presentation/      # Presentation pages
│   ├── 📁 letter/            # Letter pages
│   └── 📁 cv/                # CV pages
├── 📁 components/            # React components
│   ├── 📁 ui/                # Radix UI components
│   ├── 📁 resume/            # Resume-specific components
│   ├── 📁 presentation/      # Presentation components
│   └── 📁 letter/            # Letter components
├── 📁 lib/                   # Utility libraries
│   ├── 📄 gemini.ts          # AI integration
│   ├── 📄 stripe.ts          # Payment processing
│   ├── 📄 supabase.ts        # Database client
│   └── 📁 parsers/           # Document parsers
├── 📁 hooks/                 # Custom React hooks
├── 📁 types/                 # TypeScript definitions
├── 📁 supabase/              # Database migrations
└── 📁 public/                # Static assets

🔗 API Documentation

🤖 AI Generation Endpoints

Generate Resume

POST /api/generate/resume
Content-Type: application/json

{
  "prompt": "Software engineer with 5 years React experience",
  "name": "John Doe",
  "email": "[email protected]",
  "phone": "+1234567890",
  "location": "San Francisco, CA"
}

Generate Presentation

POST /api/generate/presentation
Content-Type: application/json

{
  "prompt": "Marketing strategy for Q1 2025",
  "pageCount": 10,
  "template": "modern-business"
}

ATS Resume Analysis

POST /api/analyze/resume
Content-Type: multipart/form-data

{
  "file": File,
  "jobDescription": "Job requirements text"
}

💳 Payment Endpoints

Create Checkout Session

POST /api/stripe/create-checkout
Content-Type: application/json

{
  "priceId": "price_xxx",
  "successUrl": "https://app.com/success",
  "cancelUrl": "https://app.com/cancel"
}

For complete API documentation, see API.md.

🚀 Deployment

🌐 Netlify (Recommended)

DocMagic is optimized for Netlify deployment:

# Automatic deployment
git push origin main

# Manual deployment
npm run build
netlify deploy --prod --dir=.next

Configuration: The netlify.toml file is pre-configured with:

Next.js plugin
API route handling
CORS headers
Environment variables

⚡ Vercel

Alternative deployment to Vercel:

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel --prod

🐳 Docker

# Dockerfile included for containerized deployment
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "start"]

🧪 Testing

# Unit tests
npm run test

# E2E tests
npm run test:e2e

# Coverage report
npm run test:coverage

For detailed testing guidelines, see TESTING.md.

Prerequisites

Ensure you have the following installed:

Node.js: Version 18 or higher (includes npm). Download from nodejs.org.
Git: For cloning the repository. Install from git-scm.com.
A Supabase account for database and authentication. Sign up at supabase.com.
A Google Gemini API key for AI-powered document generation. Obtain from Google AI Studio.
A Stripe account for payment processing (optional for local testing without payments). Sign up at stripe.com.

Installation

Clone the Repository: Clone the project to your local machine and navigate to the project directory:
```
git clone https://github.com/yourusername/docmagic.git
cd docmagic
```
Install dependencies:
```
npm install
```
Set Up Supabase:

Log in to your Supabase dashboard and create a new project.
In the Supabase project, go to Settings > API to find your NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY.
Go to SQL Editor and run the SQL migrations found in the supabase/migrations/ directory to set up the database schema (Users, Subscriptions, Documents tables).
Enable Supabase Auth in the Supabase dashboard under Authentication > Settings and configure email authentication.

Obtain Google Gemini API Key:

Visit Google AI Studio and create an API key for Gemini 2.0 Flash.
Save the key as GEMINI_API_KEY for use in the environment variables.

Set up environment variables: Create a .env.local file with:

NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
GEMINI_API_KEY=your_gemini_api_key
STRIPE_SECRET_KEY=your_stripe_secret_key
STRIPE_WEBHOOK_SECRET=your_stripe_webhook_secret
STRIPE_PRICE_ID=your_stripe_price_id
NEXT_PUBLIC_APP_URL=http://localhost:3000

Run Database Migrations: If you haven’t already applied migrations via the Supabase dashboard, you can use the Supabase CLI:
```
npm install -g supabase
supabase init
supabase login
supabase db push
```
Run the development server:
```
npm run dev
```
Open http://localhost:3000 in your browser.

🌐 Deployment

The application is deployed on Netlify. To deploy your own instance:

Push your code to GitHub
Connect your repository to Netlify
Configure the build settings:
- Build command: npm run build
- Publish directory: .next
Add your environment variables in the Netlify dashboard

📝 API Routes Documentation

Document Generation

Endpoint	Method	Description	Request Body	Response
`/api/generate/resume`	POST	Generate a resume	`{ prompt, name, email }`	Resume JSON
`/api/generate/guided-resume`	POST	Generate guided resume	`{ personalInfo, workExperience, ... }`	Resume JSON
`/api/generate/presentation`	POST	Generate presentation	`{ prompt, pageCount }`	Slides array
`/api/generate/presentation-outline`	POST	Generate outline	`{ prompt, pageCount }`	Outline array
`/api/generate/presentation-full`	POST	Generate full presentation	`{ outlines, template, prompt }`	Slides array
`/api/generate/letter`	POST	Generate letter	`{ prompt, fromName, toName, letterType, ... }`	Letter JSON
`/api/generate/resume-guidance`	POST	Get resume guidance	`{ step, targetRole, existingData }`	Guidance JSON

Analysis

Endpoint	Method	Description	Request Body	Response
`/api/analyze/resume`	POST	Analyze resume for ATS	FormData with `file` and `jobDescription`	Analysis JSON

🤝 Contributing to Open Source

DocMagic is proudly open source! We believe in the power of community-driven development and welcome contributions from developers, designers, and users worldwide. Whether you're a seasoned developer or just starting your open source journey, there's a place for you in our community!

🌟 Ways to Contribute

🐛 Bug Reports & Fixes

Report bugs using our issue template
Fix existing bugs and earn contributor recognition
Help improve stability and user experience

✨ Feature Development

Check our roadmap for planned features
Propose new features via GitHub Discussions
Implement features that benefit the entire community

📚 Documentation & Community

Improve documentation and tutorials
Help other users in discussions and issues
Create blog posts, videos, or tutorials about DocMagic
Translate the interface to new languages

🎨 Design & UX

Contribute to UI/UX improvements
Design new templates and themes
Improve accessibility features

🚀 Getting Started as a Contributor

Fork the repository on GitHub
Clone your fork: git clone https://github.com/yourusername/docmagic.git
Set up development environment: Follow our setup guide
Find an issue: Check good first issues
Create a branch: git checkout -b feature/your-feature-name
Make your changes and test thoroughly
Submit a pull request with a clear description

🏆 Contributor Recognition

We celebrate our contributors! Every contribution gets:

🎉 Public recognition in our README and releases
🏅 Contributor badge on your GitHub profile
📈 Priority support for your own issues
🎁 Exclusive swag for significant contributions
💼 Portfolio showcase opportunities

For detailed guidelines, see CONTRIBUTING.md.

📜 Open Source License

DocMagic is free and open source software licensed under the MIT License. This means you can:

✅ Use DocMagic for any purpose (personal, commercial, educational)
✅ Modify the source code to fit your needs
✅ Distribute your own versions
✅ Contribute back to the community
✅ Fork and create your own variants

MIT License

Copyright (c) 2025 DocMagic Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

See the LICENSE file for the complete license text.

🔧 Troubleshooting

Encountering setup or runtime issues? Here are some common problems and how to fix them quickly:

🚫 1. Environment Variables Not Loaded Symptoms: Blank pages, failed API calls, authentication not working. Fix:

Make sure .env.local exists in the root directory.
Confirm you’ve filled in all required variables (e.g. NEXT_PUBLIC_SUPABASE_URL, GEMINI_API_KEY, STRIPE_SECRET_KEY, etc.).
Restart your dev server after updating .env.local.

🔐 2. Supabase Auth Not Working Symptoms: Login/Signup not working, "invalid credentials" error. Fix:

Ensure Supabase email/password auth is enabled in your project dashboard.
Double-check NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY.
Check browser console for CORS or network errors.

🧠 3. Gemini AI API Errors Symptoms: Resume/Letter/Presentation generation fails or gives 500 error. Fix:

Ensure your GEMINI_API_KEY is correct and has usage quota.
Check the Gemini model being used (gemini-2.0-flash).
Review logs in lib/gemini.ts for response or validation errors.

💳 4. Stripe Integration Issues Symptoms: Subscription not created, payment failed, webhook not triggering. Fix:

Verify all Stripe keys are added correctly in .env.local.
Ensure your webhook endpoint /api/stripe/webhook is configured in the Stripe dashboard.
Use Stripe CLI (stripe listen) for local testing.

📄 5. Document Generation Fails or Times Out Symptoms: Resume/Presentation not rendering or returning empty content. Fix:

Check if Gemini AI prompt structure is valid (non-empty fields).
Ensure your system has internet access (required to call external APIs).
Inspect console and network tab for failed API calls.

🧪 6. Tests Not Running or Failing Unexpectedly Symptoms: npm run test crashes or gives missing module errors. Fix:

Ensure all dependencies are installed via npm install.
Try running npm run type-check to validate your types.
If using Supabase locally, ensure it's running: npx supabase start.

🌐 7. "Failed to fetch" or 500 Errors in API Routes Symptoms: API routes return 404 or 500 errors. Fix:

Make sure you're using npm run dev to run the Next.js server (not just npm start).
Ensure folder structure inside app/api/ is correct and follows Next.js App Router format.
Check logs in the terminal for specific stack traces.

📦 8. Netlify/Vercel Deployment Errors Symptoms: Build fails, blank screen after deployment. Fix:

Confirm NEXT_PUBLIC_APP_URL and other env vars are set in Netlify/Vercel dashboard.
Set build command as npm run build and publish directory to .next.
Make sure next.config.js has output: "standalone" if using serverless deploys.

🐳 9. Docker Build Fails Symptoms: Errors during npm ci or npm run build inside Docker container. Fix:

Use the production image by copying only essential files before install.
Ensure you are using Node 18+ in your Dockerfile.
Clear Docker cache and rebuild: docker system prune -a
docker build --no-cache -t docmagic .

Still Need Help? Check GitHub Issues

Ask in our Discord Community

Contact us at [email protected]

🌟 Acknowledgments

Next.js Team - For the amazing React framework
Vercel - For hosting and deployment platform
Supabase - For the backend-as-a-service platform
Google AI - For Gemini AI integration
Radix UI - For accessible component primitives
Tailwind CSS - For the utility-first CSS framework
Stripe - For payment processing
Open Source Community - For the amazing tools and libraries

📞 Support & Contact

🆘 Get Help

📚 Documentation: docs.docmagic.com
💬 Discord Community: Join our Discord
🐛 Bug Reports: GitHub Issues
💡 Feature Requests: GitHub Discussions

📧 Contact Information

General: [email protected]
Support: [email protected]
Business: [email protected]
Security: [email protected]

🌐 Social Media

Twitter: @DocMagicAI
LinkedIn: DocMagic Company
GitHub: DocMagic Organization

🚀 Ready to Create Magic?

Made with ❤️ by the DocMagic Team

Transforming ideas into professional documents, one AI generation at a time.

Endpoint	Method	Description	Request Body	Response
`/api/send-email`	POST	Send email	`{ to, subject, content, letterContent, ... }`	Success status

Authentication

Endpoint	Method	Description	Request Body	Response
`/api/auth/register`	POST	Register user	`{ name, email, password }`	User data

Payments

Endpoint	Method	Description	Request Body	Response
`/api/stripe/check-subscription`	GET	Check subscription status	-	Subscription status
`/api/stripe/create-checkout`	POST	Create checkout session	-	Checkout URL
`/api/stripe/create-portal`	POST	Create customer portal	-	Portal URL
`/api/stripe/webhook`	POST	Handle Stripe webhooks	Stripe event	Success status

User

Endpoint	Method	Description	Request Body	Response
`/api/user`	GET	Get user data	-	User data with subscription

🔒 Authentication

Authentication is handled by Supabase Auth. The system includes:

User registration with email/password
Secure login
Protected routes with middleware
User profile management
Session persistence

💾 Database Schema

The Supabase database includes the following tables:

Users Table

id (UUID, primary key)
email (text, unique)
name (text)
password (text, hashed)
stripe_customer_id (text, optional)
created_at (timestamp)
updated_at (timestamp)

Subscriptions Table

id (UUID, primary key)
user_id (UUID, foreign key to users)
stripe_subscription_id (text, unique)
stripe_price_id (text)
stripe_current_period_end (timestamp)
status (text)
created_at (timestamp)
updated_at (timestamp)

Documents Table

id (UUID, primary key)
user_id (UUID, foreign key to users)
title (text)
type (text) - resume, presentation, letter, cv
content (jsonb) - document data
prompt (text) - original user prompt
created_at (timestamp)
updated_at (timestamp)

💰 Subscription Model

DocMagic offers a freemium model:

Free tier: Basic document generation with limited features
Pro tier: Unlimited documents, premium templates, and advanced features

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

See the CONTRIBUTING.md file for detailed guidelines.

📄 License

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

🙏 Acknowledgements

Next.js
Supabase
Tailwind CSS
shadcn/ui
Google Gemini AI
Stripe
Pexels for professional images
Recharts for data visualization
Netlify for hosting

## 🌟 Top Contributors

We sincerely thank the amazing individuals who have contributed to DocMagic. Your time, effort, and ideas make this project better every day.

Want to contribute? Check out our CONTRIBUTING.md guide and submit your first PR!

Built with ❤️ by the DocMagic Team

Designed by Xenonesis

Name		Name	Last commit message	Last commit date
Latest commit History 286 Commits
.vscode		.vscode
app		app
components		components
hooks		hooks
lib		lib
public		public
supabase/migrations		supabase/migrations
types		types
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTION.md		CONTRIBUTION.md
Enable_shareable_public_URL_for_created_PowerPoint_presentations_73.md		Enable_shareable_public_URL_for_created_PowerPoint_presentations_73.md
LICENSE		LICENSE
README.md		README.md
build-status.md		build-status.md
components.json		components.json
contribution.md		contribution.md
netlify.toml		netlify.toml
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json
vercel.json		vercel.json

License

SushritaSingh/DocMagic

Folders and files

Latest commit

History

Repository files navigation

🪄 DocMagic - AI Document Creation Platform

🚀 Transform Ideas into Professional Documents with AI Magic

🎯 50,000+ Documents Created • 🏆 99% Success Rate • ⭐ 4.9/5 User Rating • 🌍 50+ Countries

✨ Core Features & Capabilities

🤖 AI-Powered Document Generation

🎨 Modern UI/UX Design

🤖 AI-Powered Document Generation

🛠️ Professional Tools & Features

🛠️ Tech Stack & Architecture

🎨 Frontend Excellence

🔧 Advanced Component System

🔐 Authentication & Security

💳 Payment & Subscription System

🗄️ Backend & Database

🤖 AI & External Services

💳 Payments & Subscriptions

🚀 Deployment & Performance

🎨 UI/UX Design Philosophy

✨ Modern Glass Morphism Interface

🎯 User Experience Highlights

📱 Mobile-First Responsive Design

🌓 Intelligent Theme System

⚡ Performance-Optimized Interactions

📸 Platform Screenshots

🏠 Landing Page with Glass Morphism Design

📄 AI Resume Generator Interface

🎯 Presentation Studio with Smart Layouts

🏗️ Technical Architecture

🚀 Frontend Stack

🔧 Backend & Services

📊 Document Processing Pipeline

🔍 ATS Analyzer System

📁 Project Structure

🚀 Quick Start Guide

🌐 Learn More

📋 Prerequisites

⚡ One-Click Setup

🔧 Environment Configuration

🗄️ Database Setup

🤖 AI Service Setup

💳 Payment Setup (Optional)

🛠️ Development Commands

📁 Project Structure

🔗 API Documentation

🤖 AI Generation Endpoints

Generate Resume

Generate Presentation

ATS Resume Analysis

💳 Payment Endpoints

Create Checkout Session

🚀 Deployment

🌐 Netlify (Recommended)

⚡ Vercel

🐳 Docker

🧪 Testing

Prerequisites

Installation

🌐 Deployment

📝 API Routes Documentation

Document Generation

Analysis

🤝 Contributing to Open Source

🌟 Ways to Contribute

🐛 Bug Reports & Fixes

✨ Feature Development

📚 Documentation & Community

🎨 Design & UX

🚀 Getting Started as a Contributor

🏆 Contributor Recognition

📜 Open Source License

🔧 Troubleshooting

🌟 Acknowledgments

📞 Support & Contact

🆘 Get Help

Packages