Development — Conventions

Code style, testing and release workflow.

Code style

TypeScript strict mode for the web app.
Python with ruff for the backend.
Tailwind CSS for styling — no custom CSS unless token-driven.
Conventional commits: feat:, fix:, chore:, docs:.

Testing

# Web app
npm test
 
# Backend
cd backend && pip install -r requirements-dev.txt && pytest -q
 
# Docs build
cd aetheris-docs && npm run build

Prisma workflow

npx prisma migrate dev --name feature_name   # create migration
npx prisma generate                          # regenerate client
npx prisma migrate deploy                    # apply in production

Release workflow

Create a feature branch.
Make changes, run tests.
Open a PR against main.
Merge after review.
Vercel auto-deploys main to production.

Environment setup

Copy .env.example and fill in:

DATABASE_URL=postgresql://aetheris:password@127.0.0.1:5432/aetheris
REDIS_URL=redis://127.0.0.1:6379
AETHERIS_SECRET=<random-32-chars>
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=<random-32-chars>

Development Installer reference