Retro Terminal Portfolio

A nostalgic DOS-style terminal experience for the modern web.
Built for developers, designers, and creators who want a portfolio that stands out.

_{Developed with YEN - the personal terminal experience}

---

Why This Exists

Most portfolios look the same. This one doesn't.

Visitors interact with your work through a command-line interface - typing commands, exploring projects, and discovering your story like they're hacking into a retro mainframe. It's memorable, it's fun, and it showcases your personality.

What You Get

• 65+ project slots - Showcase your entire body of work
• 23 color themes - From classic green phosphor to synthwave pink
• Full keyboard navigation - Arrow keys, tab completion, shortcuts
• WCAG 2.1 AA accessible - Screen reader friendly
• Mobile responsive - Works everywhere
• Blazing fast - Static generation, zero client-side data fetching

---

Quick Start

Requires Bun v1.3.6+

# Clone the repo
git clone https://github.com/8bittts/8leeai.git
cd 8leeai

# Install dependencies
bun install

# Start development server
bun run dev

Open http://localhost:1333 and start customizing.

---

Make It Yours

1. Update Your Data

Edit lib/data.ts to add your projects, education, and experience:

export const projects: ReadonlyArray<PortfolioItem> = [
  {
    id: "my-project",
    name: "My Project - Short Description",
    url: "https://myproject.com",
    linkWord: "Project",  // clickable word in the listing
  },
  // Add up to 65 projects
];

2. Customize Themes

23 themes included in lib/themes/. Create your own or modify existing ones:

Theme	Vibe
default	Classic green terminal
amber	Warm vintage CRT
synthwave	80s neon purple/pink
nord	Cool arctic blues
dracula	Dark with purple accents
solarized	Easy on the eyes

Switch themes with the theme command or theme [name].

3. Deploy

# Build for production
bun run build

# Deploy to Vercel (recommended)
vercel --prod

---

Terminal Commands

Your visitors can use these commands:

Command	What It Does
1-65	Open project by number
66-70	View education
71-76	See volunteer work
help	Show all commands
theme	List available themes
theme [name]	Switch to a theme
random	Surprise me with a project
email	Get contact info
clear	Reset the terminal
Ctrl+L	Quick clear shortcut

---

Tech Stack

Layer	Technology
Framework	Next.js 16 (App Router + Turbopack)
UI	React 19
Styling	Tailwind CSS v4
Language	TypeScript 5.9 (strict mode)
Runtime	Bun 1.3.6
Linting	Biome
Deployment	Vercel

---

Project Structure

app/           Next.js App Router pages and layouts
components/    Reusable UI components
lib/
  data.ts      Your portfolio content
  themes/      23 color theme definitions
  commands.ts  Terminal command logic
  utils.ts     Helper functions
public/        Static assets

---

Theme Examples

---

Contributing

This is a personal portfolio template. Fork it, make it yours. If you build something cool, I'd love to see it.

For development workflows and coding conventions, check the project's internal docs.

Claude Code Integration

This project uses Claude Code with global rules from ~/.claude/CLAUDE.md. Project-specific rules are in CLAUDE.md.

Global configuration backup (for recovery on new computers) is maintained in the deathnote project at claude-global.md.

---

Built with YEN

YEN is a personal terminal experience that makes command-line work beautiful.
Fast, customizable, and designed for developers who live in the terminal.

---

MIT License
_{Use it, modify it, ship it.}