Let's Event

Simple, fast meeting scheduling—no hassle.

Let's Event is a lightweight alternative to Calendly. Share your availability, let others book directly. That's it.

---

🚀 Quick Start

# Clone repository
git [clone git@github.com:edgarberlinck/event.me.git](https://lightroasted.vps-kinghost.net/rmcampos/event.me)
cd event.me

# Install dependencies
npm install

# Setup environment
cp .env.example .env
# Edit .env with your database URL and auth secrets

# Start PostgreSQL (Docker)
docker-compose up -d

# Run migrations
npx prisma db push

# Start development server
npm run dev

Visit: http://localhost:3000

---

📚 Documentation

For Developers

Technical Documentation

• System architecture
• Database schema
• API routes
• Testing strategy
• Deployment guide

For Business

Business Documentation

• Product overview
• Value proposition
• Target audience
• Feature roadmap
• Go-to-market strategy

---

🛠️ Tech Stack

• Framework: Next.js 16 (App Router with Turbopack)
• Language: TypeScript 5
• Database: PostgreSQL 16 + Prisma 7
• Auth: NextAuth v5 (Credentials + Google OAuth)
• Integrations: Google Calendar API (auto event creation + Meet links)
• UI: Tailwind CSS 4 + shadcn/ui
• Testing: Playwright (E2E) + Vitest (Unit)
• Code Quality: Biome 2.4.4

---

📦 Scripts

npm run dev          # Start development server
npm run build        # Production build
npm start            # Start production server
npm run lint         # Check code quality (Biome)
npm run format       # Format code (Biome)
npm test             # Run E2E tests (Playwright)
npm run test:ui      # Playwright UI mode
npm run db:studio    # Open Prisma Studio

---

🎯 Current Status

Phase 1: Authentication & Foundation ✅

• User registration & login
• Protected dashboard
• Database schema
• CI/CD pipeline
• Pre-commit hooks (Biome)
• E2E tests passing

Phase 2: Core Scheduling ✅

• ✅ Availability management
• ✅ Event type creation with booking constraints
  • Max bookings per week
  • Minimum notice hours
  • Maximum notice days

Phase 3: Booking System ✅

• ✅ Public booking pages with calendar UI
• ✅ Real-time slot availability
• ✅ Booking creation with validation
• ✅ Booking management dashboard
• ✅ Cancel bookings
• ✅ Constraint enforcement
• ✅ Booking confirmation
• ✅ 32 E2E tests passing

Phase 4: Google Calendar Integration ✅

• ✅ Google OAuth authentication
• ✅ Automatic calendar event creation
• ✅ Google Meet link generation
• ✅ Guest invitations
• ✅ Token refresh handling

Phase 5: Enhancements 📋

• Email notifications (booking confirmations, reminders)
• Advanced time zone support
• Payment integration
• Recurring availability

---

🧪 Testing

E2E Tests (Playwright)

npm test                    # All tests
npm run test:headed        # With browser UI
npm run test:debug         # Debug mode

Unit Tests (Vitest)

npm run test:unit          # Run unit tests

Coverage: 32 E2E tests covering:

• Authentication (register/login/logout)
• Availability management
• Event type CRUD with constraints
• Public booking flow
• Booking validation

---

🔐 Environment Variables

# Database
DATABASE_URL="postgresql://postgres:postgres@localhost:55002/eventme"

# Authentication (generate with: openssl rand -base64 32)
NEXTAUTH_URL="http://localhost:3000"
NEXTAUTH_SECRET="your-secret-here"
AUTH_URL="http://localhost:3000"
AUTH_SECRET="your-secret-here"

---

🚀 Deployment

Vercel from Gitea

Since this project is hosted on Gitea, we use Vercel CLI for deployment:

1. Create Vercel project:

   npm i -g vercel
   vercel login
   vercel link
   

2. Get environment variables:

   cat .vercel/project.json
   # Note: VERCEL_ORG_ID and VERCEL_PROJECT_ID
   

3. Add Gitea Secrets:

   • Go to Gitea → Repository Settings → Secrets
   • Add VERCEL_TOKEN (get from vercel tokens create)
   • Add VERCEL_ORG_ID from project.json
   • Add VERCEL_PROJECT_ID from project.json

4. Push to main - Deployment triggers automatically via .gitea/workflows/deploy.yml

Neon Database Setup

1. Create project at neon.tech
2. Copy connection string from Neon Console
3. Set as DATABASE_URL in Vercel Environment Variables:

   vercel env add DATABASE_URL
   

Alternative: Docker

docker-compose up --build

Includes PostgreSQL + Next.js app.

---

📖 Project Structure

event.me/
├── app/                    # Next.js App Router
│   ├── (auth)/            # Auth pages (login, register)
│   ├── dashboard/         # Protected dashboard
│   └── api/               # API routes (NextAuth)
├── components/            # React components
│   └── ui/               # shadcn/ui components
├── lib/                   # Utilities & database
│   ├── prisma.ts         # Prisma client
│   └── utils.ts          # Helper functions
├── prisma/               # Database schema & migrations
│   └── schema.prisma     # Data model
├── tests/                # E2E tests (Playwright)
├── docs/                 # Documentation
│   ├── technical/        # Technical docs
│   └── business/         # Business docs
└── .github/              # CI/CD workflows

---

🤝 Contributing

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

Before submitting:

• Run npm run lint (must pass)
• Run npm test (all tests must pass)
• Update documentation if needed

---

📝 License

MIT License - see LICENSE file for details

---

🙏 Acknowledgments

• Next.js - React framework
• Prisma - Database ORM
• NextAuth - Authentication
• shadcn/ui - UI components
• Biome - Fast linting & formatting

---

Built with ❤️ in Brazil 🇧🇷