Files
ss-tools/specs/003-project-launch-script/quickstart.md
busya ec6421de35 rename ss-tools to superset-tools across the entire project
- Replace all occurrences of 'ss-tools' with 'superset-tools' in 104 files
- Rename git bundle file ss-tools.bundle → superset-tools.bundle
- Update .gitignore pattern accordingly
- Preserve variable names (hasSsTools etc.) and code identifiers
2026-06-16 11:15:19 +03:00

900 B

Quickstart: Project Launch Script

Prerequisites

  • Linux/macOS environment
  • Python 3.9+
  • Node.js 18+

Installation

No installation required. The script is part of the repository.

Usage

  1. Navigate to the project root:

    cd superset-tools
    
  2. Make the script executable (if not already):

    chmod +x run.sh
    
  3. Run the script:

    ./run.sh
    

What it does

  1. Checks for python3 and npm.
  2. Sets up a Python virtual environment in backend/.venv if it doesn't exist.
  3. Installs backend dependencies from backend/requirements.txt.
  4. Installs frontend dependencies if frontend/node_modules is missing.
  5. Starts the backend server on port 8000.
  6. Starts the frontend server on port 5173.
  7. Streams logs from both services to the terminal.
  8. Gracefully stops both services when you press Ctrl+C.