🎭 Chan Meng

Interactive CLI Experience

An NPX-executable CLI application that introduces Chan Meng through an interactive, story-driven terminal experience.
Experience minimalist philosophy through an elegant command-line interface.
One-click FREE execution via NPX - no installation required.

Tech Stack Badges:

🎨 Welcome Screen Vibrant gradient ASCII art with minimalist tagline	🎯 Interactive Menu Choose between Quick Tour and Full Experience
🗺️ The Journey Story-driven exploration of minimalist philosophy	💭 Philosophy Deep dive into minimalist principles
📧 Connect Multiple ways to get in touch with Chan Meng

Experience a curated journey through Chan's minimalist philosophy via an elegant CLI interface with beautiful ASCII art and gradient colors.

Key capabilities include:

• 🚀 Quick Tour Mode: A curated 3-minute introduction
• 📚 Full Experience Mode: Explore all modules at your own pace
• 💾 Smart Progress Tracking: Automatically saves and resumes your journey
• 🎨 Beautiful Terminal UI: ASCII art, gradient colors, and boxed content
• ♿ Universal Accessibility: Graceful degradation for limited terminals

Built with minimalist principles at its core - every dependency justified, every feature purposeful.

Design Principles:

• ✅ 7 Dependencies: Carefully selected within constitutional limit of 10
• ✅ Fast Startup: < 5 seconds with lazy loading for heavy modules
• ✅ ES Modules: Modern JavaScript with "type": "module"
• ✅ Zero Config: Works out of the box with sensible defaults

npx chan-meng

🎉 That's it! The interactive experience will start immediately.

# Clone the repository
git clone https://github.com/ChanMeng666/chan-meng.git
cd chan-meng

# Install dependencies
npm install

# Run the CLI
node index.js

• Node.js: 18.0.0 or higher (Download)
• Terminal: Minimum 80x24 characters
• Recommended: A terminal with color support and Unicode/emoji

The CLI experience is organized into four interactive modules:

Quick Tour mode automatically selects the most impactful moments from each module for a 3-minute experience.

Runtime & Language:

• Node.js 18+: Modern JavaScript runtime
• ES2022: Latest ECMAScript features with ES Modules

CLI Framework:

• inquirer ^9.0.0 - Interactive command-line prompts
• chalk ^5.0.0 - Terminal string styling with colors
• boxen ^7.0.0 - Create beautiful boxes in terminal
• ora ^7.0.0 - Elegant terminal spinners

Visual Enhancement:

• figlet ^1.7.0 - ASCII art text generation (lazy loaded)
• gradient-string ^2.0.0 - Beautiful color gradients (lazy loaded)

Configuration:

• conf ^11.0.0 - Simple config management with encryption support

chan-meng/
├── index.js              # Entry point with shebang for npx
├── package.json          # NPM configuration
├── src/
│   ├── cli.js           # Main CLI orchestration and flow control
│   ├── content/         # Story content modules (journey, philosophy, etc.)
│   ├── modules/         # Interactive module handlers
│   ├── services/        # Core services
│   │   ├── display.js   # Display service for UI rendering
│   │   ├── progress.js  # Progress tracking service
│   │   └── navigation.js # Navigation and menu service
│   └── utils/           # Utility modules
│       ├── terminal.js  # Terminal capability detection
│       └── config.js    # Configuration management
├── tests/
│   ├── unit/            # Unit tests
│   └── integration/     # Integration tests
└── specs/               # Specification documents
    └── features/        # Feature specifications

User preferences and progress are automatically saved in:

Stored Data:

• Module completion status
• User preferences (tour mode, display settings)
• Last interaction timestamp

npm install

# Run all tests
npm test

# Run tests with coverage
npm test -- --coverage

# Run tests in watch mode
npm test -- --watch

# Create distributable package
npm pack

# Test the package locally
npx ./chan-meng-1.0.0.tgz

Development Scripts:

npm test          # Run Jest test suite
npm run lint      # Run ESLint (when configured)
npm pack          # Create tarball for distribution

Performance Metrics:

• ⚡ < 5s Startup time with lazy loading
• 🎯 80%+ Test coverage (lines)
• 📦 7 Dependencies (within constitutional limit of 10)
• 💨 ~1MB Package size

Code Quality:

• ✅ ES Modules: Modern JavaScript architecture
• ✅ Jest Testing: Comprehensive unit and integration tests
• ✅ Spec-Driven Development: Built using Spec Kit methodology
• ✅ Constitutional Constraints: Principled dependency management

Accessibility:

• ♿ Terminal Detection: Automatic capability detection
• 🎨 Graceful Degradation: Works on limited terminals
• 🌍 Universal Compatibility: Cross-platform support (Linux, macOS, Windows)

Contributions are welcome! This project follows minimalist principles - every addition must justify its existence.

Development Process:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Follow the existing code style and conventions
4. Add tests for new functionality
5. Ensure all tests pass (npm test)
6. Submit a pull request

Contribution Guidelines:

• Respect the constitutional limit of 10 dependencies
• Maintain startup time < 5 seconds
• Add meaningful tests (maintain 80%+ coverage)
• Update documentation as needed
• Follow the minimalist philosophy

This project is licensed under the MIT License - see the LICENSE file for details.

Open Source Benefits:

• ✅ Commercial use allowed
• ✅ Modification allowed
• ✅ Distribution allowed
• ✅ Private use allowed

Chan Meng Creator & Lead Developer

Chan Meng - Senior AI/ML Infrastructure Engineer

• LinkedIn: chanmeng666
• GitHub: ChanMeng666
• Email: [email protected]
• Portfolio: chanmeng.live