How joegsuero/terminal-playground works
Terminal Playground is a browser-based Linux and Docker command-learning simulator. Users choose a mode, enter commands in a terminal, and receive simulated output in a safe environment; lessons and help support that learning path, while challenges and achievements add progress feedback. The Linux shell executes registered commands against a virtual filesystem; Docker has a separate session and simulated engine. The graph preserves these runtime and learning branches. Some page wiring and Docker-terminal details were not excerpted, so those links are marked unverified rather than presented as inspected calls.
Main entry points: Index Learning Page · TmuxTerminal.tsx Terminal Multiplexer · terminalStore.ts Progress Store · ShellSession.ts Linux Session
Components 24
Application UI
- App Router
src/App.tsx - Learning Page
src/pages/Index - Mode Selector
src/components/ModeSelector.tsx
Terminal Runtime
- Terminal Multiplexer
src/components/Terminal/TmuxTerminal.tsx - Readline Shell
src/lib/ReadlineShell.ts - Editor Overlay
src/components/Terminal/EditorOverlay.tsx - REPL Contract
src/lib/repl.ts
Linux Simulation
- Linux Session
src/lib/ShellSession.ts - Linux Commands
src/commands/linux - Shell Parsing
src/lib/shell.ts - Virtual Filesystem
src/lib/vfs.ts
Docker Simulation
- Docker Terminal
src/components/Terminal/DockerTerminal.tsx - Docker Session
src/lib/DockerSession.ts - Docker Commands
src/commands/docker - Docker Engine State
src/lib/DockerEngine.ts
Learning Progress
- Linux Lessons
src/data/linuxLessons.ts - Docker Lessons
src/data/dockerLessons.ts - Progress Store
src/store/terminalStore.ts - Achievements
src/lib/achievements.ts - Daily Challenges
src/lib/challenges.ts - Challenge View
src/hooks/useChallenges.ts - Achievement View
src/hooks/useAchievements.ts - Achievement Toaster
src/components/Gamification/AchievementToaster.tsx
Other components
- Learner
Connections 26
- Learner → App Router: opens
- App Router → Learning Page: routes to
src/App.tsx - Learning Page → Mode Selector: presents
src/pages/Index/Header.tsx - Learning Page → Terminal Multiplexer: offers terminal
- Mode Selector → Docker Terminal: selects Docker
- Mode Selector → Terminal Multiplexer: selects Linux
- Terminal Multiplexer → Readline Shell: uses
src/components/Terminal/TmuxTerminal.tsx - Terminal Multiplexer → REPL Contract: calls session
src/components/Terminal/TmuxTerminal.tsx - Terminal Multiplexer → Editor Overlay: renders
src/components/Terminal/TmuxTerminal.tsx - Linux Session → REPL Contract: implements
src/lib/repl.ts - Linux Session → Linux Commands: dispatches
src/lib/ShellSession.ts - Linux Session → Shell Parsing: parses with
src/lib/ShellSession.ts - Linux Session → Virtual Filesystem: reads and writes
src/lib/ShellSession.ts - Docker Terminal → Docker Session: runs commands
- Docker Session → Docker Commands: dispatches
src/lib/DockerSession.ts - Docker Session → Docker Engine State: uses state
src/lib/DockerSession.ts - Learning Page → Linux Lessons: offers lessons
- Learning Page → Docker Lessons: offers lessons
- Challenge View → Daily Challenges: gets challenge
src/hooks/useChallenges.ts - Challenge View → Progress Store: reads and updates
src/hooks/useChallenges.ts - Achievement View → Achievements: gets catalogue
src/hooks/useAchievements.ts - Achievement View → Progress Store: reads progress
src/hooks/useAchievements.ts - Progress Store → Achievements: evaluates unlocks
src/store/terminalStore.ts - Progress Store → Daily Challenges: gets day key
src/store/terminalStore.ts - App Router → Achievement Toaster: mounts
src/App.tsx - Achievement Toaster → Progress Store: reads pending awards
src/components/Gamification/AchievementToaster.tsx