1
0
Fork 0
BitHarbor/README.md
2026-04-29 15:35:06 +02:00

1 KiB

BitHarbor

Simple Laravel + Vue ecommerce demo with:

  • Product listing
  • Category sidebar (tree structure)
  • Login, register, forgot password, reset password (SPA flow)

Project Structure

  • backend/ Laravel API + auth (Fortify + Sanctum)
  • frontend/ Vue 3 + Vite SPA

Requirements

  • PHP 8.2+
  • Composer
  • Node.js 20+
  • npm

Setup

Backend

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

Set these env values in backend/.env:

APP_URL=http://localhost:8000
FRONTEND_URL=http://localhost:5173

Then run migrations + seed:

php artisan migrate:fresh --seed

Start backend server:

php artisan serve --port=8000

Frontend

cd frontend
npm install

Create/update frontend/.env:

VITE_API_BASE_URL=http://localhost:8000

Start frontend:

npm run dev

Notes

  • Password reset links are generated for SPA URLs using FRONTEND_URL.
  • If config/routes seem stale, run:
php artisan optimize:clear