ShipSec Studio uses just as its command runner. Run just or just help to see all available commands.
Getting Started
Initialize Project
Sets up the development environment:
- Installs dependencies with Bun
- Creates environment files from examples (
backend/.env, worker/.env, frontend/.env)
Development Commands
Start Development Environment
Starts the full development environment with hot-reload:
- Checks for environment files
- Starts Docker infrastructure (Postgres, Temporal, MinIO, Loki)
- Waits for services to be ready
- Runs database migrations
- Starts backend, worker, and frontend via PM2
Access points:
Stop Development
Stops all PM2 processes and Docker infrastructure.
View Logs
Streams logs from all application processes via PM2.
Check Status
Shows status of PM2 processes and Docker containers.
Production Commands
Start Production
Starts the production environment using Docker Compose with pre-built images.
Access points:
Build and Start
Builds Docker images and starts the production environment.
Stop Production
Stops all production containers.
View Production Logs
Streams logs from all production containers.
Check Production Status
Shows status of production containers.
Clean Production
Stops containers, removes volumes, and prunes Docker system.
Infrastructure Commands
Start Infrastructure
Starts only the infrastructure containers:
- PostgreSQL
- Temporal
- MinIO
- Redis
- Loki
Stop Infrastructure
Stops all infrastructure containers.
View Infrastructure Logs
Streams logs from infrastructure containers.
Clean Infrastructure
Stops infrastructure and removes all volumes.
Utility Commands
Show All Status
Comprehensive status check showing:
- PM2 services
- Infrastructure containers
- Production containers
Reset Database
Drops and recreates the database, then runs migrations. This deletes all data.
This command requires PostgreSQL to be running (just dev or just infra up).
Build Images Only
Builds production Docker images without starting containers.
Quick Reference
| Command | Description |
|---|
just init | Initialize environment |
just dev | Start development |
just dev stop | Stop development |
just dev logs | View dev logs |
just dev status | Check dev status |
just prod | Start production |
just prod build | Build and start production |
just prod stop | Stop production |
just prod logs | View production logs |
just prod clean | Clean production data |
just infra up | Start infrastructure |
just infra down | Stop infrastructure |
just infra logs | View infrastructure logs |
just infra clean | Clean infrastructure data |
just status | Show all status |
just db-reset | Reset database |
just build | Build images |
just help | Show help |
Environment Files
The just init command creates these environment files:
| File | Purpose |
|---|
backend/.env | Backend API configuration |
worker/.env | Worker configuration |
frontend/.env | Frontend configuration |
.env.example template. 
