A terminal-emulator portfolio — fully data-driven, forkable in 10 minutes.

Links

• 📦 Repository — github.com/srs-sudeep/Termx
• 🌐 Live Demo — termx.vercel.app
• 🎬 Video Demo — youtu.be/-oJOWGoLEAc

TermX was inspired by satnaing/terminal-portfolio.

• Powerline-style prompt — oh-my-zsh inspired colored segments (user@host ▶ path ▶ ❯) that adapt to the active theme.
• Ghost-text autocomplete — inline suggestions with Tab cycling and → to accept, no popup lists in the buffer.
• Looks and feels like a real terminal — boot sequence, command history, autocomplete, ANSI-style output, and a Matrix-rain easter egg.
• 14 themes built in — Tokyo Night by default; switch with theme set <name> or the settings panel.
• Easy to make your own — update one config file (src/config/user.config.ts) with your name, projects, experience, and links.
• Strong first impression — large ASCII banner of your name plus a portrait emblem on the welcome screen.
• Remembers your preferences — theme, font, and other settings persist via localStorage.
• Works well on desktop and mobile — responsive layout, accessible focus management, reduced-motion support.
• Private by design — 100% client-side, no analytics, no backend, no account.
• Quality-gated — lint, typecheck, and 180+ tests run via Husky pre-push hook.

Welcome screen	Help

whoami	projects

experience	education

contact	neofetch

sudo / fortune	Settings panel

Switch with theme set <name> or open the settings panel.

tokyo-night (default)	termfolio	dracula
nord	one-dark	monokai
gruvbox-dark	gruvbox-light	solarized-dark
solarized-light	hacker	matrix
retro	light

core
  help        Show available commands
  clear       Clear the terminal  (alias: cls)
  echo        Print text
  whoami      Who am I
  date        Current date and time
  history     Show command history
  man         Manual page for a command
  pwd         Current directory
  ls          List directory contents
  cd          Change directory

portfolio
  about       Who I am  (alias: bio)
  projects    Browse my projects  (alias: work)
  skills      My skills
  experience  Work experience
  education   Education history
  contact     Get in touch
  social      Social profiles
  resume      Download my résumé  (alias: cv)

system
  theme       Manage terminal themes
  font        Change font family or size
  settings    Open the settings panel
  reset       Reset all preferences

fun
  neofetch    System info, terminal-style
  banner      Large ASCII name
  cowsay      Classic cowsay
  fortune     Random programming wisdom
  coffee      418 I'm a teapot
  sudo        Permission denied: nice try.
  matrix      Enter the Matrix  (Esc to exit)
  hack        Elite hacking simulation

# 1. Fork this repo on GitHub, then clone your fork
git clone https://github.com/YOUR_HANDLE/TermX.git
cd TermX

# 2. Install dependencies
bun install

# 3. Edit your personal data — this is the only file you need to touch
$EDITOR src/config/user.config.ts

# 4. Start the dev server
bun run dev

Open http://localhost:5173.

Everything user-editable lives in src/config/.

// src/config/commands.config.ts
import type { Command } from '@/types';

export const customCommands: Command[] = [
  {
    name: 'spotify',
    description: 'Open my Spotify profile',
    category: 'custom',
    execute: () => ({
      type: 'redirect',
      url: 'https://open.spotify.com/user/yourhandle',
      newTab: true,
    }),
  },
];

// src/config/themes.config.ts — append to the themes array
{
  name: 'catppuccin',
  label: 'Catppuccin Mocha',
  mode: 'dark',
  colors: {
    bg: '#1e1e2e', fg: '#cdd6f4', cursor: '#f5e0dc',
    prompt: '#a6e3a1', accent: '#cba6f7',
    success: '#a6e3a1', error: '#f38ba8',
    warning: '#f9e2af', info: '#89dceb',
    muted: '#6c7086', selection: '#313244', border: '#45475a',
  },
  font: { family: '"JetBrains Mono", monospace', size: '14px', lineHeight: '1.6' },
},

Then run theme set catppuccin.

TermX is a static SPA — deploy anywhere.

bun run build   # output: dist/

bun run dev           # start Vite dev server (HMR)
bun run build         # tsc --noEmit + vite build
bun run preview       # preview the production build locally
bun run typecheck     # tsc --noEmit only
bun run lint          # ESLint (zero warnings allowed)
bun run lint:fix      # auto-fix lint issues
bun run format        # Prettier write
bun run format:check  # Prettier check (CI)
bun run test          # Vitest (single run)
bun run test:watch    # Vitest watch mode
bun run test:coverage # coverage report
bun run validate      # lint + typecheck + tests (CI gate)
bun run prepush       # format + validate (run before pushing)

Installed automatically on bun install:

• pre-commit — runs lint + typecheck on every commit
• pre-push — runs format + lint + typecheck + tests before push

Bypass with --no-verify if absolutely needed (not recommended).

src/
├── config/      ← USER-EDITABLE: your personal data + settings
├── commands/    ← one file per command (core / portfolio / system / fun)
├── components/  ← React UI components
├── hooks/       ← custom React hooks
├── lib/         ← framework-agnostic logic (parser, registry, storage)
├── store/       ← Zustand stores (terminal, theme)
├── types/       ← TypeScript types (single source of truth)
└── styles/      ← global CSS + theme variable definitions

MIT — fork freely, that's the point.