README.md

metadata

title: Prosento RepEx
emoji: 🧾
sdk: docker
app_port: 7860

RepEx Web Starter

React (Vite) frontend + FastAPI backend with local session storage.

Project Layout

/
  server/
    app/
      api/
        routes/
          health.py
          sessions.py
        router.py
      core/
        config.py
      services/
        session_store.py
      main.py
  frontend/
    public/
      assets/
    src/
      components/
      pages/
      lib/
    index.html
    vite.config.ts

Quick Start (Dev)

Backend (API)

python -m venv .venv
.venv\Scripts\activate
pip install -r server/requirements.txt
uvicorn server.app.main:app --reload --port 8000

Frontend (Vite)

cd frontend
npm install
npm run dev

Open http://localhost:5173.

Production

cd frontend
npm run build

Start the API server; it will serve frontend/dist if present:

uvicorn server.app.main:app --host 0.0.0.0 --port 8000

Configuration

Environment variables for the API:

• APP_NAME (default: Starter API)
• API_PREFIX (default: /api)
• CORS_ORIGINS (comma-separated, default: http://localhost:5173)
• STORAGE_DIR (default: data)
• MAX_UPLOAD_MB (default: 50)
• FRONTEND_BASE_URL (default: http://localhost:5173)
• PDF_TIMEOUT_MS (default: 90000)

Frontend environment variables:

• VITE_API_BASE (optional, default: /api)

PDF Export (ReportLab)

The server generates PDFs using ReportLab at:

GET /api/sessions/{session_id}/export.pdf

Install dependencies:

pip install -r server/requirements.txt