An interactive learning platform for Arbitrum Stylus smart contract development. The curriculum teaches Rust-based contract development through a wizardry theme — 51 lessons across three difficulty tiers, with XP, levels, achievement badges, and public completion certificates.

Live at stylus.academy.

• Node 20+
• pnpm 9+
• Docker
• A Supabase project

pnpm install

cp apps/web/.env.example apps/web/.env
cp apps/api/.env.example apps/api/.env

apps/web/.env

VITE_API_URL=http://localhost:3001
VITE_SUPABASE_URL=your-project-url
VITE_SUPABASE_ANON_KEY=your-anon-key

apps/api/.env

PORT=3001
SUPABASE_URL=your-project-url
SUPABASE_SERVICE_KEY=your-service-role-key
DOCKER_CONTAINER_NAME=stylus-runner

pnpm db:push    # push schema.sql to Supabase
pnpm db:seed    # seed curriculum data

docker-compose -f docker/docker-compose.yml up -d

pnpm dev

Frontend runs on http://localhost:3000, API on http://localhost:3001.

pnpm dev           # start all apps
pnpm dev:web       # frontend only
pnpm dev:api       # API only
pnpm build         # build all apps
pnpm lint          # lint all apps
pnpm test          # run all tests

1. User writes Rust in the Monaco editor
2. Frontend posts to /api/exercises/:id/submit
3. API saves the submission with status running
4. API calls docker exec into stylus-runner to compile and run tests
5. Results are written back to Supabase and returned to the client

The compiler container runs with no network access and strict resource limits. Each submission gets an isolated directory that is removed after compilation.

See CONTRIBUTING.md for the full guide.

The short version:

• Branch from main — use feature/short-description or fix/short-description
• Keep PRs small and focused on one change
• Run pnpm lint and pnpm build before opening a PR
• For any UI change, include a screenshot in the PR description
• For curriculum changes, walk through the lesson manually on a fresh account before submitting

MIT — Tolga Yaycı