PPT Maker

An AI-powered presentation generator that transforms your ideas into professional presentations in seconds.

Features

• AI-Powered Generation: Uses OpenAI GPT-4 to create structured presentation outlines
• Customizable Settings: Choose slide count, tone (professional/casual/creative), and purpose (pitch/report/educational/marketing/general)
• Professional Layouts: 9 different slide layouts for visual variety
• No Authentication Required: Simple, frictionless experience
• Modern UI: Built with Next.js 14, TypeScript, and Tailwind CSS

Tech Stack

• Frontend: Next.js 14, TypeScript, Tailwind CSS, shadcn/ui
• Backend: Next.js API Routes, Drizzle ORM, PostgreSQL
• AI: OpenAI GPT-4o-mini
• Database: PostgreSQL (Docker)

Getting Started

Prerequisites

• Node.js 18+ and npm
• Docker and Docker Compose
• OpenAI API key

Installation

1. Clone the repository:

git clone <your-repo-url>cd ppt-maker

2. Install dependencies:

npm install

3. Set up environment variables:

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

# Database (Docker Compose PostgreSQL)
DATABASE_URL="postgresql://pptmaker:pptmaker_dev@localhost:5432/pptmaker"# OpenAI
OPENAI_API_KEY="sk-..."# App URLs
NEXT_PUBLIC_APP_URL="http://localhost:3000"

4. Start PostgreSQL with Docker:

# Start PostgreSQL container
docker-compose up -d
# Check if PostgreSQL is running
docker ps

5. Set up the database:

# Generate migrations
npx drizzle-kit generate
# Push to database
npx drizzle-kit push
# (Optional) View database in Drizzle Studio
npx drizzle-kit studio

6. Run the development server:

npm run dev

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

Usage

1. Navigate to Create: Click "Get Started" or go to /create
2. Enter Prompt: Describe your presentation topic and requirements
3. Configure Settings: Select slide count, tone, and purpose
4. Generate: Click "Generate Presentation" and wait for AI to create your outline
5. View Outline: Review the generated slides with titles, key points, and visual suggestions

Project Structure

ppt-maker/
├── app/
│ ├── (protected)/ # Protected routes (no auth required now)
│ │ ├── dashboard/ # User dashboard
│ │ ├── create/ # Presentation creation
│ │ └── presentations/ # Presentation view
│ └── api/
│ └── generate/ # AI generation endpoints
├── components/
│ ├── ui/ # shadcn/ui components
│ ├── layout/ # Layout components
│ ├── create/ # Creation components
│ └── outline/ # Outline display components
├── lib/
│ ├── ai/ # OpenAI integration
│ ├── db/ # Database and queries
│ └── utils/ # Utility functions
├── types/ # TypeScript types
├── docs/ # Documentation
└── docker-compose.yml # PostgreSQL container

Docker Commands

# Start PostgreSQL
docker-compose up -d
# Stop PostgreSQL
docker-compose down
# View logs
docker-compose logs -f postgres
# Restart PostgreSQL
docker-compose restart
# Remove database (WARNING: deletes all data)
docker-compose down -v

Scripts

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

Database Management

# Generate migrations
npx drizzle-kit generate
# Push schema to database
npx drizzle-kit push
# View database in Drizzle Studio
npx drizzle-kit studio

Environment Variables

See .env.example for all required environment variables.

Deployment

With Docker Database

For deployment with Docker PostgreSQL, ensure your hosting platform supports Docker Compose or set up PostgreSQL separately.

Vercel Deployment

1. Push your code to GitHub
2. Import your repository in Vercel
3. Configure environment variables (use external PostgreSQL like Neon or Supabase for production)
4. Deploy

Other Platforms

Ensure your platform supports:

• Node.js 18+
• PostgreSQL database connection
• Environment variables

Contributing

Contributions are welcome! Please follow these steps:

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 ISC License.

Acknowledgments

• Next.js
• OpenAI
• shadcn/ui
• Drizzle ORM
• PostgreSQL

Support

For issues and questions:

• Check the documentation
• Open an issue on GitHub

---

Built with ❤️ using Next.js and AI