DeckBuilder - Clash Royale Deck Management API

Quick Start

Prerequisites

• Docker & Docker Compose
• Node.js
• Git

1. Clone the Repository

git clone https://github.com/PantocaPipoca/DeckBuilder.git
cd DeckBuilder

2. Env Setup

Create a .env file in the root:

cp .env.example .env

3. Start the App

docker-compose up -d

This will:

• Start PostgreSQL database (port 5432)
• Start the API server (port 4000)

4. Run Database Migrations

docker-compose exec server npx prisma migrate deploy

5. Seed the Database

docker-compose exec server npx ts-node src/configs/seed.ts

This creates:

• 1 test user (email: dev@dev.com, passwword: devdev)
• Clash Royale cards with all needed stats for good life

6. Start Frontend

Run:

cd client
npm install
npm run dev

7. Verify Installation

Verify Backend

• Go to http://localhost:4000 for the backend

Verify Frontend

• Go to http://localhost:5173 for the front

If both open without errors, your installation is working!

Reset Database

docker-compose exec server npx prisma migrate reset --force
docker-compose exec server npx ts-node src/configs/seed.ts

Stop the App

docker-compose down

Restart with Fresh Data

docker-compose down -v  # Remove volumes
docker-compose up -d
docker-compose exec server npx ts-node src/configs/seed.ts

Author

Pantas