UFO Park Workshop

This repository contains the UFO Park Workshop project, which includes multiple applications and libraries. This guide will help you set up the project locally and run the applications.

Prerequisites

Before you begin, ensure you have the following installed on your system:

• Node.js (>= 14.x)
• Yarn (>= 1.22.x)
• Docker
• Git

Getting Started

1. Clone the Repository

Clone the repository to your local machine using Git.

git clone https://github.com/mohammadufo/ufo-park.git
cd ufo-park

2. Install Dependencies

Install the project dependencies using Yarn.

yarn install

3. Set Up Environment Variables

Copy apps/api/.env.example to apps/api/.env and fill it in. For the local Docker database, DATABASE_URL and DIRECT_URL can be the same URL.

4. Run the Database with Docker Compose

Start the PostgreSQL database using Docker Compose.

docker-compose up -d

5. Run Prisma Migrations

After the database is running, apply Prisma migrations to set up the database schema.

yarn prisma migrate dev

6. Run the Applications

You can run the individual applications using the following commands:

API Application

Navigate to the apps/api directory and start the API server.

cd apps/api
yarn start:dev

WEB Applications

Navigate to the apps/web directory and start the WEB server.

cd apps/web
yarn dev

Deploying the API

The API runs on Vercel as a single Vercel Function (apps/api/vercel.json), which works on the free Hobby plan.

1. In Neon, copy two connection strings: the pooled one (host contains -pooler) and the direct one (without -pooler). Drop &channel_binding=require, add &connect_timeout=15 to both, and add &pgbouncer=true to the pooled one.
2. In Vercel: Add New → Project, import this repo, set Root Directory to apps/api and Framework Preset to Other. Leave the build settings alone; vercel.json provides them.
3. Add the environment variables from apps/api/.env.example (DATABASE_URL = pooled, DIRECT_URL = direct), plus HUSKY=0, then deploy.
4. The build runs prisma migrate deploy, so the tables are created on the first deploy.
5. Optional demo data: open the Neon SQL Editor, paste apps/api/prisma/seed/demo-data.sql and run it once (20 garages around New York). Or, from your machine with DATABASE_URL and DIRECT_URL pointing at Neon, run cd apps/api && npx prisma db seed.
6. In the Next.js apps, set NEXT_PUBLIC_API_URL to the API's Vercel URL and NEXTAUTH_SECRET to the same value as the API's JWT_SECRET.

License

This project is licensed under the MIT License.