URL Shortener Monorepo

This workspace contains:

• backend/ Laravel 10 REST API
• frontend/ React + Vite + TypeScript SPA

Run With Docker (Recommended)

1. Create docker env file:

cp .env.docker.example .env.docker

2. Build and start:

docker compose --env-file .env.docker up --build -d

First startup may take 1-3 minutes because MySQL initializes.

3. Stop:

docker compose --env-file .env.docker down

4. Stop and remove DB volume:

docker compose --env-file .env.docker down -v

Folder Structure

url-shortener/
  backend/
  frontend/
  docker-compose.yml

Run Locally

1. Start backend:

cd backend
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan serve

2. Start frontend (new terminal):

cd frontend
npm install
cp .env.example .env
npm run dev

URLs

• Backend: http://localhost:8000
• Frontend: http://localhost:5173
• MySQL: localhost:3306