An interactive terminal-based CV application built with xterm.js, featuring a professional terminal emulator interface with system information display, process monitoring, and file navigation.

• Native Terminal Feel: Built on xterm.js 5.3.0 with FitAddon for dynamic column/row sizing
• Professional Color Scheme: Dark theme (#0B0F14 background) with high-contrast text (#E6EEF3)
• Full Keyboard Support: Arrow keys, Tab autocomplete, command history, Backspace, and escape sequences
• WCAG AA Compliant Colors: Accessible color palette with orange (#E95420) and teal (#17B890) accents

File Operations: ls, cd, pwd, cat, less, tree, grep

System Info: whoami, hostnamectl, uname, neofetch, htop, btop

Utilities: help, history, open, xdg-open, clear, exit

• Neofetch: Real-time system information with ASCII art
• HTTop/BTTop: Live process monitoring with color-coded CPU/memory, real-time updates (500ms), press 'q' to exit

• Command History: Navigate with arrow keys (↑/↓)
• Tab Autocomplete: Auto-complete commands and file paths
• Colored Prompt: Shows username, hostname, and current path
• Responsive Design: Terminal adapts to container size

terminal-cv/ ├── src/ │ ├── data/ # CV data (user-editable) │ │ ├── cv-content.js # Your CV content - edit this! │ │ └── README.md # Customization guide │ ├── index.html │ ├── css/ │ │ ├── style.css │ │ └── terminal.css │ ├── js/ │ │ ├── data.js # File system logic │ │ ├── utils.js │ │ ├── system.js │ │ ├── commands.js │ │ └── xterm-terminal.js │ └── assets/ │ ├── cv_SRichter2026.pdf │ └── neofetch.txt ├── tests/ # Test suite ├── README.md └── package.json 

• Modern web browser (Chrome, Firefox, Safari, Edge)
• Local web server (for local development)

1. Clone or Download the repository
2. Customize your CV (see Customization section)
3. Run a local server:

# Using Python 3 python3 -m http.server 8000 # Using Node.js npx http-server src -p 8000 # Using npm (if installed) npm install npm run serve # Then open http://localhost:8000

This project is designed to be easily customizable! All CV data is separated from the production code for easy personalization.

1. Edit src/data/cv-content.js - This file contains all your CV information:

   • Professional summary (about)
   • Work experience (experience)
   • Education (education)
   • Skills and certifications (skills)
   • Contact information (contact)

2. Save and refresh - Your changes will appear immediately when you reload the page

3. Follow the formatting guidelines in the file comments for best results

See src/data/README.md for comprehensive customization instructions including:

• Structure of the CV data
• Formatting tips
• Examples and best practices
• Troubleshooting

✅ Recommended to edit:

• src/data/cv-content.js - All your personal CV information
• src/assets/cv_*.pdf - Replace with your actual PDF resume

⚠️ Production code (no need to edit for basic customization):

• src/js/data.js - File system and presentation logic
• src/js/commands.js - Command handlers
• Other files in src/js/ - Core terminal functionality

$ pwd / $ ls assets about cv skills $ cd about $ cat bio.txt $ neofetch [Shows system info with colors] $ htop [Live process monitoring - press 'q' to exit] $ history [Show command history] $ [Press Arrow Up] [Navigate command history] $ [Press Tab] [Auto-complete commands and paths]

• Frontend: HTML5, CSS3, JavaScript ES6+
• Terminal: xterm.js v5.3.0 + FitAddon
• File System: Virtual JavaScript-based
• Process Simulator: Dynamic CPU/Memory simulation

Edit src/js/commands.js:

function handleMyCommand(args) { return 'Output here'; } commandRegistry['mycommand'] = { desc: 'Description', handler: handleMyCommand };

• Colors: Edit theme object in src/js/xterm-terminal.js
• Font: Modify .xterm class in src/css/terminal.css
• Container Size: Adjust .terminal-container height in src/css/terminal.css
• Virtual File System: Extend the file system structure in src/js/data.js

• Lightweight: ~50KB JavaScript
• Responsive: Auto-adapts to container size
• Efficient: 500ms update interval for live monitoring

Comprehensive test suite with 59 passing tests covering app responsiveness, cursor movement, autocompletion, and all commands.

npm install # Install test dependencies npm run test:unit # Run unit tests (39 tests) npm run test:integration # Run integration tests (20 tests) npm run test:e2e # Run E2E browser tests (22 tests)

• ✅ Responsiveness: Terminal initialization and resizing
• ✅ Cursor Movement: Arrow keys, backspace, character insertion
• ✅ Autocompletion: Tab completion for commands and paths
• ✅ Command Functionality: All 19 commands with error handling
• ✅ Command History: Up/down arrow navigation
• ✅ Special Modes: htop, password prompts

See TESTING_SUMMARY.md and tests/README.md for details.

Terminal not showing: Verify xterm.js CDN scripts load and terminal div exists

Commands not working: Use help to see available commands, check spelling (case-sensitive)

Misaligned columns in htop: FitAddon should handle this, try clearing and re-running

Version: 1.0.1 | Last Updated: February 6, 2026