nexminal

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 13 Open GitHub ↗

Build a complete production-grade NEXUS Terminal browser-based terminal emulator web application with Next.js 16, TypeScript, and Tailwind CSS.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Nexus-Terminal

## Task ID: 1 - main-builder
### Work Task
Build a complete production-grade NEXUS Terminal browser-based terminal emulator web application with Next.js 16, TypeScript, and Tailwind CSS.

### Work Summary

## Project Overview
Built a full-featured browser-based terminal emulator called "NEXUS Terminal v2.0.0" as a single-page Next.js application. The terminal runs entirely client-side with no API dependencies and provides a realistic, polished terminal experience.

## Files Created (40+ files)

### Core Library Files (`src/lib/terminal/`)
1. **types.ts** - All TypeScript interfaces (FileNode, TerminalSession, TerminalLine, CommandResult, GameState, Theme, etc.)
2. **virtualFileSystem.ts** - Complete Linux-like virtual filesystem with root structure, home directory, /etc, /var, /tmp, /usr, /proc. Supports create/read/update/delete, path resolution, file permissions, hidden files.
3. **commandParser.ts** - Input parser supporting quoted strings, flags, piping, output redirection (> >>), command chaining (&& ||)
4. **commandHistory.ts** - Per-session command history with arrow key navigation, reverse search (Ctrl+R), and search
5. **tabCompletion.ts** - Autocompletion for commands, file paths, flags, and game names
6. **environment.ts** - Environment variable system with expansion ($VAR, ${VAR}) and tilde expansion
7. **themes.ts** - 9 color themes (Dracula, One Dark, Monokai Pro, Solarized Dark, Nord, Tokyo Night, Catppuccin Mocha, Matrix, Gruvbox)
8. **asciiArt.ts** - ASCII art collection including NEXUS logo, Abhishek Shah text, neofetch logo, cowsay animals (9 types), figlet, box borders, SL train art
9. **fortune.ts** - 50+ fortune messages
10. **index.ts** - Main terminal engine orchestrator that ties all components together

### Command Modules (`src/lib/terminal/commands/`)
11. **index.ts** - Command exports
12. **navigation.ts** - ls (with -l, -a, -R flags), cd (with ~, .., -), pwd, tree
13. **fileOps.ts** - cat, touch, mkdir, rmdir, rm, cp, mv, echo, write, head, tail
14. **system.ts** - whoami, hostname, uname, date, uptime, clear, history, exit, neofetch, top/htop, ps
15. **network.ts** - ping, curl, ifconfig/ip, traceroute, ssh, wget (all simulated)
16. **utilities.ts** - calc, base64, md5, sha256, rev, sort, wc, grep, find, diff, uniq, tr, sed, xargs
17. **fun.ts** - cowsay, fortune, matrix, color, figlet, lolcat, sl, cmatrix, oneko
18. **devInfo.ts** - about, contact, resume, social (developer info for Abhishek Shah)
19. **games.ts** - games menu, play command, score display
20. **other.ts** - help, man, theme, weather, todo, notes, nano, alias, export, env, which, whatis, df, free, cal, stopwatch, timer, password, uuid, lorem, qr, logo

### Game Engines (`src/lib/terminal/games/`)
21. **index.ts** - Game exports
22. **snake.ts** - Grid-based snake with arrow/WASD controls, scoring, collision detection
23. **tetris.ts** - Full Tetris with 7 piece types, rotation, line clearing, levels, next piece preview
24. **game2048.ts** - 4x4 2048 game with tile merging, score tracking, game over detection
25. **trivia.ts** - 24 trivia questions across Technology, Science, Geography, History, Math categories

### React Components (`src/components/terminal/`)
26. **Terminal.tsx** - Main terminal component with multi-tab support, theme switching, keyboard shortcuts (Ctrl+L, Ctrl+Shift+T, Ctrl+W, Ctrl+1-9), state management
27. **TerminalInput.tsx** - Input field with colored prompt, autocomplete popup, history navigation, reverse search mode, auto-focus
28. **TerminalOutput.tsx** - Scrollable output renderer with HTML support, color-coded line types, click-to-copy
29. **TerminalTabs.tsx** - Tab bar with add/close/select functionality
30. **TerminalStatusBar.tsx** - Status bar showing path, session count, theme name, time

### App Files
31. **page.tsx** - Dynamic import of Terminal component (no SSR)
32. **layout.tsx** - Dark mode root layout with JetBrains Mono font, terminal favicon
33. **globals.css** - Terminal-specific styles including custom scrollbar, cursor animation, selection colors, theme dropdown styling

## Features Implemented
- **30+ commands** across 8 categories
- **4 playable games**: Snake, Tetris, 2048, Trivia Quiz
- **9 color themes** with live switching
- **Virtual filesystem** with Linux-like directory structure
- **Multi-tab terminal** with independent sessions
- **Tab completion** for commands, paths, and flags
- **Command history** with arrow keys and Ctrl+R search
- **Full keyboard shortcuts** system
- **Developer info display** (about, contact, resume, social)
- **Splash screen** with NEXUS ASCII art logo and fortune

## Quality
- **0 ESLint errors** (1 warning for font loading, which is expected)
- **Clean dev server** with successful compilations
- **All TypeScript** with proper type safety
- **No external API dependencies**
- **Responsive** full-screen design

---
## Task ID: 2 - vercel-build-fix
### Work Task
Fix Vercel build failure caused by missing module exports in GameCanvas.tsx

### Root Cause Analysis
Three issues were found and fixed:

1. **BUILD BREAKER: `GameCanvas.tsx` line 5** — Imported `handleGameInput` and `renderGame` from `@/lib/terminal`, but neither function is exported from `src/lib/terminal/index.ts`. The index imports them from `./commands` but only uses them internally (not re-exported). The correct exports are `handleGameKey` (which wraps `handleGameInput`) and `getCurrentGameRender` (which wraps `renderGame`).

2. **RUNTIME BUG: `GameCanvas.tsx` line 37** — Was calling `handleGameInput(session, e.key)` and destructuring `{ updatedSession, result }`, but `handleGameInput` returns `{ newState, result }` — so `updatedSession` was `undefined`, causing a crash. Fixed by using `handleGameKey(session, e.key)` which correctly returns `{ updatedSession, result }`.

3. **DEAD CODE: `Terminal.tsx` line 7** — Imported `handleGameKey` and `getCurrentGameRender` but never used them. Removed unused imports.

4. **LINT ERROR** — `useMemo` in GameCanvas had dependency mismatch `[session.gameState, session.gameMode]` but the inferred dependency was `session` (since `getCurrentGameRender(session)` takes the whole object). Fixed dependency to `[session]`.

5. **NEXT CONFIG** — Removed `output: "standalone"` (not needed for Vercel), set `ignoreBuildErrors: false` for strict TS checking.

### Files Modified
- `src/components/terminal/GameCanvas.tsx` — Fixed imports and function calls
- `src/components/terminal/Terminal.tsx` — Removed unused imports
- `next.config.ts` — Cleaned up config

### Verification
- ESLint: 0 errors, 1 warning (expected font warning)
- Dev server: Compiles clean, page returns HTTP 200
- All module exports verified across 40+ files

nexminal

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README