WithinTech Learn is an LMS designed to provide Withintech camp and programs participants access to a vast array of courses that will equip them with the skills needed to thrive in this AI era.
1. Folder Structure
withintech-learn/
├── apps/
│ ├── api/ # Express REST API — TypeScript, Prisma, PostgreSQL
│ └── web/ # Next.js frontend
├── packages/
│ └── shared/ # Shared types across apps
├── docs/ # GitBook docs served by the docs container
├── infra/
│ ├── nginx/ # Reverse-proxy config
│ └── postgres/ # DB init SQL
├── docker-compose.yml
└── .env
2. Setup & Running
Prerequisites: Node.js 20+, pnpm 9+, PostgreSQL 16
# Install all dependencies
pnpm install
# Copy env file and fill in values
cp .env.example .env
# Apply DB migrations
cd apps/api && npx prisma migrate deploy
# Seed the first admin account
pnpm --filter @withintech-learn/api seed
# Run both apps in parallel
pnpm dev
API → http://localhost:3001 · Web → http://localhost:3000
# Serve GitBook docs
pnpm run docs
Docs → http://localhost:4000
3. Tools Used
| Layer | Stack |
|---|---|
| Frontend | Next.js 14, TanStack Query, Tailwind CSS, Sonner |
| Backend | Express, TypeScript, Prisma ORM |
| Database | PostgreSQL |
| Storage | AWS S3 / Backblaze B2 (S3-compatible) |
| Nodemailer (SMTP) | |
| Monitoring | Sentry |
| Infra | Docker, Nginx, GitHub Actions |
4. Environment Variables
| Variable | Purpose |
|---|---|
DATABASE_URL |
PostgreSQL connection string |
POSTGRES_USER / POSTGRES_PASSWORD |
Docker Compose PostgreSQL credentials |
REDIS_URL |
Redis connection string |
JWT_ACCESS_SECRET |
Signing access tokens |
JWT_REFRESH_SECRET |
Signing refresh tokens |
GOOGLE_CLIENT_ID / NEXT_PUBLIC_GOOGLE_CLIENT_ID |
Google OAuth |
AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY |
S3-compatible file storage |
S3_BUCKET_NAME / AWS_REGION / STORAGE_PROVIDER |
Storage bucket and provider |
SMTP_HOST / SMTP_PORT / SMTP_USER / SMTP_PASS |
Email delivery |
EMAIL_FROM |
Sender address |
XENTRIPAY_API_KEY / XENTRIPAY_BASE_URL |
Xentripay payments |
ADMIN_SEED_EMAIL |
Email for the initial admin account |
SENTRY_DSN |
Error tracking |
APP_URL / NEXT_PUBLIC_APP_URL |
App origin (used in certificates and CORS) |
NEXT_PUBLIC_API_URL |
API base URL consumed by the frontend |
EXECUTOR_URL / EXECUTOR_SECRET |
API-to-executor connection |
JUDGE0_URL / JUDGE0_SECRET_KEY_BASE |
Judge0 execution engine |
NODE_ENV / PORT / BCRYPT_ROUNDS |
Runtime settings |
NEXT_PUBLIC_BRAND_NAME / NEXT_PUBLIC_SUPPORT_* / NEXT_PUBLIC_SOCIAL_* |
Public branding and support metadata |
Full details are in docs/environment.md.
5. Deployment
The app runs on a single VPS using Docker Compose. Nginx sits in front as a reverse proxy on ports 80/443 and routes traffic to the web (3000) and API (3001) containers. PostgreSQL runs on the host machine.
Deployments are triggered via GitHub Actions on push to main. The workflow SSHs into the server, pulls the latest image, and uses docker-rollout for zero-downtime container replacement.
# Full stack build and start
docker compose up --build -d
