read.me # Y Storfa API | GitHub Clone Repository

1) Make directory
   mkdir YStorfa && cd YStorfa

2) Clone the repo
   git clone https://github.com/OcDame-dev/Y-Storfa.git .

3) Create .env (example shown)
   echo DB_USER=postgres> .env.example
   echo DB_PASSWORD=secret>> .env.example
   echo DB_HOST=localhost>> .env.example
   echo DB_PORT=5432>> .env.example
   echo DB_NAME=library_db>> .env.example
   echo DATABASE_URL=postgresql://postgres:secret@localhost:5432/library_db?schema=public>> .env.example
   echo JWT_SECRET=ataurkey>> .env.example
   echo NODE_ENV=development>> .env.example
   echo PORT=3000>> .env.example

4) Copy example to real env
   copy .env.example .env

5) Start Docker services
   docker compose up -d

6) Install dependencies
   npm install

7) Run the app (dev)
   npm run dev

Extra Commands
- docker compose up -d    # start db
- docker compose down     # stop db
- docker compose logs -f  # follow logs
- docker compose down -v  # delete db volumes

Troubleshooting
- Port in use: change PORT in .env
- DB connection fail: ensure docker is running and DATABASE_URL matches
- Missing tables: re-run schema import
