Seed Project - React + FastAPI

Minimalist template for quick project startup with React SPA (Vite) and FastAPI backend.

📁 Project Structure

lab_seed/
├── backend/
│   ├── main.py           # FastAPI application
│   └── requirements.txt   # Python dependencies
└── frontend/
    ├── src/
    │   ├── components/    # React components
    │   ├── styles/        # BEM CSS styles
    │   ├── App.jsx        # Main component
    │   └── main.jsx       # Entry point
    ├── index.html
    ├── package.json
    └── vite.config.js

🚀 Quick Start

Backend (FastAPI)

1. Navigate to backend directory:

cd backend

2. Create virtual environment (recommended):

python -m venv venv
source venv/bin/activate  # Linux/Mac
# or
venv\Scripts\activate     # Windows

3. Install dependencies:

pip install -r requirements.txt

4. Start server:

uvicorn main:app --reload

Backend will run on: http://localhost:8000

Frontend (React + Vite)

1. Navigate to frontend directory:

cd frontend

2. Install dependencies:

npm install

3. Start development server:

npm run dev

Frontend will run on: http://localhost:5173

🔧 Available Commands

Backend

• uvicorn main:app --reload - Start server with hot reload

Frontend

• npm run dev - Start development server
• npm run build - Create production build
• npm run preview - Preview production build

📡 API Endpoints

• GET / - Health check
• GET /api/health - API health status
• GET /api/items - List all items
• POST /api/items - Create new item
• GET /api/items/{id} - Get item detail
• DELETE /api/items/{id} - Delete item

🎨 Styling

Project uses BEM methodology for CSS:

.block {}
.block__element {}
.block--modifier {}

CSS variables are defined in frontend/src/styles/index.css.

🛠 Technologies

• Frontend: React 18, Vite 5, BEM CSS
• Backend: FastAPI, Pydantic, Uvicorn
• Communication: REST API with CORS support

📝 Notes

• Project is configured for development with automatic proxy for API calls
• Data is stored in memory only (for demo purposes)
• CORS is set up for localhost:5173 (Vite default)