A modern event scheduling app that helps groups find the perfect time to meet. Create an event, share a link, and let everyone pick their available dates.

Features

📅 Easy Event Creation - Set a date range and get a shareable link instantly
🗓️ Visual Calendar - Guests can click to select their available dates
📊 Analytics Dashboard - See who's available when with a heatmap view
🔒 Password Protected - Only you can access the analytics
🐳 Dockerized - Deploy anywhere with a single command

Quick Start

Using Docker (Recommended)

# Clone the repository
git clone <your-repo-url>
cd timepickr

# Start the application
docker-compose up -d

# Run migrations
docker-compose run --rm migrate

# Open http://localhost:3000

Local Development

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your PostgreSQL database URL

# Generate Prisma client
npx prisma generate

# Run migrations
npx prisma migrate dev

# Start development server
npm run dev

# Open http://localhost:3000

Tech Stack

Frontend: Next.js 14 (App Router), React, CSS
Backend: Next.js API Routes
Database: PostgreSQL with Prisma ORM
Containerization: Docker & Docker Compose

Project Structure

timepickr/
├── src/
│   ├── app/
│   │   ├── api/events/         # API routes
│   │   ├── event/[code]/       # Event & analytics pages
│   │   ├── page.tsx            # Home page
│   │   └── globals.css         # Stripe-inspired styles
│   ├── components/             # Reusable components
│   └── lib/                    # Database client
├── prisma/                     # Database schema
├── Dockerfile                  # Production build
├── docker-compose.yml          # Container orchestration
└── README.md

Environment Variables

Variable	Description	Default
`DATABASE_URL`	PostgreSQL connection string	-
`NEXT_PUBLIC_APP_URL`	Public URL of the app	`http://localhost:3000`

API Endpoints

Method	Endpoint	Description
`POST`	`/api/events`	Create a new event
`GET`	`/api/events/:code`	Get event details
`POST`	`/api/events/:code/responses`	Submit availability
`GET`	`/api/events/:code/responses`	Get all responses
`POST`	`/api/events/:code/analytics`	Get analytics (auth required)

License

MIT