How rmishr-1/playwright_learning_studio works
Playwright Learning Studio teaches a Playwright and TypeScript course: learners browse lessons, edit exercise code, and run it against a practice site, with live browser, console, and terminal feedback. The SPA calls the loopback backend for course content, progress, checks, and runs; the backend owns persistence and execution. The desktop launcher is a separate delivery mode that downloads and starts the studio and course. Links reflect the excerpts and SOURCE INDEX; unsampled components are included only where the README documents their role.
Main entry points: routes.ts API routes · client.ts API client · main.ts Desktop launcher · server.ts HTTP server
Components 23
Learner experience
- React studio
frontend-c/src/App.tsx - Lesson screens
frontend-c/src/screens/Day.tsx - Lesson blocks
frontend-c/src/components/LessonBlocks.tsx - Run panels
frontend-c/src/components/RunOverlay.tsx - Terminal panel
frontend-c/src/components/TerminalView.tsx - API client
frontend-c/src/api/client.ts - Terminal session
frontend-c/src/lib/terminalSession.ts
Studio backend
- HTTP server
backend/src/server.ts - API routes
backend/src/routes.ts - Course content
backend/src/content.ts - Progress storage
backend/src/store.ts - Code runner
backend/src/runner.ts - Practice preview
backend/src/preview.ts - Terminal service
backend/src/terminal/index.ts - Learner workspace
backend/src/terminal/workspace.ts
Shared contracts
- Wire contracts
shared/contracts/course_day.ts
Desktop launcher
- Desktop launcher
desktop/src/main.ts - Release handling
desktop/src/release.ts - Runtime install
desktop/src/runtime-install.ts - Licence handling
desktop/src/licence.ts
Other components
- Learner
- Practice website
- Learner browser
Connections 27
- Learner → React studio: uses
README.md - React studio → Lesson screens: routes to
frontend-c/src/App.tsx - Lesson screens → Lesson blocks: renders
frontend-c/src/components/LessonBlocks.tsx - Lesson blocks → API client: loads lesson data
frontend-c/src/api/client.ts - Lesson screens → API client: requests content and progress
- API client → HTTP server: sends API requests
frontend-c/src/api/client.ts - HTTP server → API routes: mounts API
backend/src/server.ts - API routes → Course content: reads course
backend/src/routes.ts - API routes → Progress storage: reads and updates
backend/src/routes.ts - API routes → Code runner: prepares and starts
backend/src/routes.ts - API routes → Terminal service: dispatches commands
backend/src/routes.ts - API routes → Learner workspace: reads learner files
backend/src/routes.ts - Code runner → Practice website: drives browser
- API routes → Practice preview: serves preview pages
backend/src/routes.ts - HTTP server → Practice preview: serves preview
backend/src/server.ts - API client → Run panels: streams run events
- Run panels → Terminal panel: shows terminal
- Terminal panel → Terminal session: sends terminal input
- Terminal session → API client: calls terminal API
frontend-c/src/lib/terminalSession.ts - Terminal service → Learner workspace: saves and resolves files
backend/src/terminal/index.ts - Wire contracts → API client: types API data
frontend-c/src/api/client.ts - Wire contracts → API routes: validates requests
backend/src/routes.ts - Desktop launcher → Licence handling: checks licence
desktop/src/main.ts - Desktop launcher → Release handling: opens release
desktop/src/main.ts - Desktop launcher → Runtime install: ensures runtime
desktop/src/main.ts - Desktop launcher → Learner browser: opens studio window
- Desktop launcher → HTTP server: starts embedded studio