🧭 Project Overview: Event Booking Platform

This repository contains a full-stack event booking system built with a modern web architecture for Areeb Web Development Competition:

• Frontend: React, Vite, TailwindCSS v4, TanStack Router, i18next
• Backend: Hono (Fast web framework), Drizzle ORM, Hexagonal Architecture + DDD principles
• Infrastructure: Docker Compose, PostgreSQL, Redis (optional), GitHub Actions, Vercel/Cloud hosting

---

🌍 Access the Platform

• Frontend: https://areeb-frontend.vercel.app
• Backend API: https://areeb-backend.vercel.app

---

🤖 AI Usage

AI was utilized throughout the development process to enhance productivity and inform decisions:

• Frontend: Assistance with design system implementation, component creation, UI styling, and various parts of the application logic.
• Backend: Help with writing tests, automating repeated development tasks, and discussions around design decisions.
• General: Support in project planning, architecture discussions, and generating documentation.

---

🖼️ System Architecture Diagram

---

📁 Monorepo Structure

apps/
  frontend/     → Vite-based SPA frontend
  backend/      → Hono-based REST API backend

---

🧠 Design Decisions

• Adopted hexagonal architecture for testability & future adapters
• Used CSS variables + @theme for dark mode
• TanStack Router enables modular route-driven file setup
• Full i18n-ready frontend

---

✅ CI/CD

• GitHub Actions build & deploy
• Vercel (frontend and backend)

---

🚀 Getting Started

Prerequisites

• Bun >= 1.2.0
• Docker + Docker Compose

1. Clone the repo

git clone https://github.com/kofta999/evently.git
cd evently

2. Setup environment

cp .env.example .env

3. Install dependencies

bun install

4. Start dev servers

bun dev