My personal portfolio as an interactive terminal in the browser built with TypeScript, HTML and CSS — no framework.
- Boot sequence in BIOS / systemd style — skip it with any key, click or tap
- Commands like
about,experience,projectsand more — typehelpto see them all - Themes:
phosphor,amber,matrix,draculaandubuntu— switch withtheme <name> - CRT effect with scanlines, glow and flicker — turn it off with
crt off - Shell feel: command history (↑ / ↓), tab completion and Ctrl+L to clear
- Theme and CRT setting are remembered in the browser,
prefers-reduced-motionis respected
Requires Node.js (version in .nvmrc).
npm install
npm run dev # dev server with hot reload| Script | What it does |
|---|---|
npm run dev |
Start the dev server |
npm run build |
Type check and build the site into dist/ |
npm run preview |
Serve the built site locally |
npm test |
Run the unit tests (Vitest) |
npm run lint |
Check the code with ESLint |
npm run format |
Format all files with Prettier |
npm run typecheck |
Run the TypeScript compiler without building |
Every push and pull request runs lint, type check, tests and build in CI.
Pushes to main are deployed to GitHub Pages automatically.
Dependencies are kept up to date by Renovate.
├── index.html
├── public/ # copied as-is: favicon + self-hosted Ubuntu Mono
├── src/
│ ├── main.ts # entry point — wires everything together
│ ├── data/
│ │ ├── content.ts # all portfolio texts — edit this to update content
│ │ ├── bootLines.ts # the lines shown while booting
│ │ └── types.ts # shape of the content
│ ├── commands/ # one file per command
│ │ └── index.ts # list of registered commands
│ ├── terminal/
│ │ ├── types.ts # the Command interface
│ │ ├── Terminal.ts # input line, output, key handling
│ │ ├── CommandRegistry.ts
│ │ ├── CommandHistory.ts # ↑ / ↓ history
│ │ └── parseInput.ts # "theme matrix" → { name, args }
│ ├── state/
│ │ └── settings.ts # theme + CRT state, applied to <html> and persisted
│ ├── ui/
│ │ ├── bootSequence.ts # boot screen animation
│ │ ├── statusBar.ts
│ │ └── windowChrome.ts
│ ├── utils/
│ │ ├── dom.ts # typed element lookup
│ │ ├── html.ts # escaping + small render helpers
│ │ ├── storage.ts # safe localStorage access
│ │ └── time.ts # clock, uptime and login date formatting
│ └── styles/
│ ├── base.css # fonts, theme tokens, reset, page layout, window chrome
│ ├── crt.css # CRT effects (scanlines, glow, flicker) + "crt off"
│ └── terminal.css # terminal, command output, boot screen, status bar
└── tests/ # unit tests, same folder layout as src/
Tests live in tests/, in the same folder layout as src/ (e.g. tests/utils/html.test.ts tests src/utils/html.ts).
Dependencies are passed in explicitly (e.g. createSettings(root, store)), so modules don't reach for globals
and can be tested in isolation. src/main.ts is the only place that wires everything together.
All texts live in src/data/content.ts. The commands only render them, so there's no need to touch any other file.
Create src/commands/hello.ts:
import type { Command } from '../terminal/types';
import { escapeHtml } from '../utils/html';
export const helloCommand: Command = {
name: 'hello',
description: 'Shown in help',
run(args) {
// Return an HTML string, or null for no output.
// Always escape anything that isn't a fixed string.
return `<p>Hello, ${escapeHtml(args || 'world')}!</p>`;
},
};Then import it and add it to the list in createCommands() in src/commands/index.ts.
A command that needs a dependency, like the settings, is created by a factory function — see src/commands/theme.ts.
The code is licensed under the MIT License.
Ubuntu Mono is licensed under the Ubuntu Font Licence 1.0.