40 lines
894 B
Markdown
40 lines
894 B
Markdown
# 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:
|
|
```bash
|
|
cd ss-tools
|
|
```
|
|
|
|
2. Make the script executable (if not already):
|
|
```bash
|
|
chmod +x run.sh
|
|
```
|
|
|
|
3. Run the script:
|
|
```bash
|
|
./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`.
|