✉️ Letter Generator

• Multiple Types - Cover letters, formal letters, thank you notes
• Job URL Import - Paste a job listing URL for tailored cover letters
• Professional Templates - Business-ready formatting
• AI Enhancement - Improve tone and content with AI

📊 Diagram Builder

• Architecture Diagrams - System design with subgraphs and layers
• Flowcharts - Create process diagrams easily
• Mind Maps - Visualize ideas and concepts
• Sequence Diagrams - Show component interactions
• ER Diagrams - Database schema visualization
• Mermaid Syntax - Powered by Mermaid.js v11
• 9+ Professional Templates - Ready-to-use diagram templates
• Theme Integration - Adapts to light/dark modes
• Export Options - Download as PNG/SVG

🚀 Quick Start

Prerequisites

• Node.js 18+
• npm or yarn
• Supabase account (for authentication)

Installation

# Clone the repository
git clone https://github.com/Muneerali199/Draftdeckai.git
cd Draftdeckai

# 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

Open http://localhost:3000 in your browser.

Environment Variables

Create a .env.local file with these variables:

# Supabase (Required)
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# AI Provider (Required)
GEMINI_API_KEY=your_gemini_api_key

# Optional
UNSPLASH_ACCESS_KEY=your_unsplash_key
STRIPE_SECRET_KEY=your_stripe_key

🐳 Docker Quick Start

Run the entire application including the database with one command — no manual Node.js or PostgreSQL installation required.

Prerequisites

• Docker and Docker Compose

Setup

# Clone the repository
git clone https://github.com/Muneerali199/Draftdeckai.git
cd Draftdeckai

# Navigate to the project directory
cd Draftdeckai

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your API keys (and optionally SUPABASE_JWT_SECRET)

# Build and start both App and Database
docker compose up

Open http://localhost:3000 in your browser.

The setup includes:

• App Service: Next.js with hot reload (Port 3000)
• Database Service: PostgreSQL 16 (Port 5432)
• Shared Network: Inter-service communication
• Persistent Storage: Database data persists in postgres_data volume

🏗️ Tech Stack

📁 Project Structure

DraftDeckAI/
├── app/                    # Next.js App Router pages
│   ├── api/               # API routes
│   ├── auth/              # Authentication pages
│   ├── resume/            # Resume builder
│   ├── presentation/      # Presentation creator
│   ├── letter/            # Letter generator
│   └── diagram/           # Diagram builder
├── components/            # React components
│   ├── ui/               # shadcn/ui components
│   ├── resume/           # Resume-specific components
│   ├── presentation/     # Presentation components
│   └── letter/           # Letter components
├── lib/                   # Utility functions
├── hooks/                 # Custom React hooks
├── public/               # Static assets
└── supabase/             # Database migrations

🔐 Authentication

DraftDeckAI uses Supabase Auth with:

• Email/Password login
• Password reset via email
• Protected routes with middleware
• Session management

💳 Credits System

Free tier: 50 credits/month

📚 Documentation

Getting Started (⭐ Start Here!)

• docs/SETUP.md - 📖 Complete setup guide with step-by-step API key generation and troubleshooting
• CONTRIBUTING.md - Contribution guidelines

Architecture & Diagrams

• docs/DARK_MODE_PERSISTENCE.md - 🌓 Detailed dark mode persistence and FOUC prevention system guide
• docs/architecture/ARCHITECTURE_DIAGRAM_FEATURE.md - Complete guide to architecture diagrams
• docs/architecture/SYSTEM_ARCHITECTURE.md - Technical system architecture
• docs/architecture/ARCHITECTURE_IMPROVEMENTS.md - Recent improvements summary

Other Docs

• docs/Code_of_Conduct.md - Community standards
• docs/CHANGELOG.md - Version history
• docs/FAQ.md - Frequently asked questions
• docs/THEME_FIX.md - Theme-Adaptive presentation fix guide

📜 Scripts

npm run dev      # Start development server
npm run build    # Build for production
npm run start    # Start production server
npm run lint     # Run ESLint

💬 Community and Support

Join our official WhatsApp group to connect with other contributors, get help with your PRs, or discuss project ideas:

Security

If you discover any security vulnerabilities, please refer to our Security Policy for information on how to responsibly disclose them. Please do not report security vulnerabilities via public GitHub issues.

👥 Contributors

We appreciate all contributors who help improve DraftDeckAI ❤️

📊 All Contributors

https://github.com/Muneerali199/Draftdeckai/graphs/contributors

🎨 Visual Contributors

🤝 Contributing

Contributions are welcome! We've made it easy to get started:

First-time contributors? Start here:

1. 📖 Read docs/SETUP.md - Complete setup guide with all API keys
2. 📚 Check CONTRIBUTING.md - Contribution guidelines

Ready to contribute?

1. Fork the repository
2. Create your 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

Get help:

• Check GitHub Issues for tasks
• Look for good first issue label for beginner-friendly tasks
• Join our Discord community for mentorship

📄 License

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

🙏 Acknowledgments

• Next.js - React framework
• Tailwind CSS - Styling
• shadcn/ui - UI components
• Supabase - Backend & Auth
• Mistral AI - AI generation
• Mermaid.js - Diagram rendering
• Nebius Token Factory - Qwen AI models
• OpenAI - API client library

Built with ❤️ by Muneer Ali and Mayank Sahu .

⭐ Star this repo if you find it helpful!