PROMPT Intro Course

Standalone repository for the PROMPT intro course services.

Structure

• server/ Go intro course backend
• client/ Intro course developer micro-frontend
• docker-compose.yml Local development database
• docker-compose.prod.yml Production deployment for intro course services only

Local Development

1. Copy .env.template to .env and adapt values if needed. Intro-course-specific runtime variables previously kept in prompt2 now live in this repository.
2. Start the intro-course database:

   docker compose up -d

3. Run server:

   cd server
   go run main.go

4. Install client dependencies and run the client:

   cd client
   yarn install
   yarn dev

The client consumes the published @tumaet/prompt-shared-state and @tumaet/prompt-ui-components packages directly.

Use a Node LTS release (recommended: Node 22) for local client tooling.

The core app in the main PROMPT repository can load this client via Module Federation at http://localhost:3005.

Production Deployment

CI/CD workflows are in .github/workflows/:

• build-and-push.yml builds and pushes server + client images
• dev.yml runs tests, builds, and deploys to dev VM
• prod.yml runs release builds and deploys to prod VM
• deploy.yml deploys only intro-course containers using docker-compose.prod.yml