himanshuchandola 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Himanshu Chandola
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,175 @@
+# himanshuchandola-cli
+
+Interactive CLI portfolio for Himanshu Chandola - A modern terminal experience built with TypeScript.
+
+[![npm version](https://img.shields.io/npm/v/himanshuchandola.svg)](https://www.npmjs.com/package/himanshuchandola)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
+
+## Overview
+
+A TypeScript-based interactive CLI tool that serves as a terminal portfolio. Features animated ASCII banner, terminal card display, and interactive menu navigation to explore my digital presence.
+
+## Installation
+
+### Run without installing
+
+```bash
+npx himanshuchandola
+```
+
+### Install globally
+
+```bash
+npm install -g himanshuchandola
+```
+
+Then run:
+
+```bash
+himanshuchandola
+```
+
+## Usage
+
+```bash
+himanshuchandola [options]
+```
+
+### Options
+
+- `--open=<destination>` - Open a destination directly (portfolio, github, linkedin, peerlist, twitter)
+- `--no-anim` - Skip the animated banner
+- `-h, --help` - Show help message
+
+### Examples
+
+```bash
+# Open GitHub directly
+himanshuchandola --open=github
+
+# Skip animation
+himanshuchandola --no-anim
+
+# Show help
+himanshuchandola --help
+```
+
+## Features
+
+- Animated ASCII banner with color cycling
+- Beautiful terminal card with personal information
+- Interactive numbered menu for navigation
+- CLI flags for direct navigation and animation control
+- Graceful fallbacks for non-TTY environments
+- TypeScript with strict mode
+- Comprehensive test coverage
+- Automated versioning and publishing with semantic-release
+
+## Tech Stack
+
+- **TypeScript** - Type-safe development with strict mode
+- **tsup** - Fast TypeScript bundler
+- **Biome** - Fast linter and formatter
+- **Vitest** - Unit testing framework
+- **Inquirer** - Interactive command-line prompts
+- **Chalk** - Terminal string styling
+- **Boxen** - Terminal boxes
+- **Figlet** - ASCII art text
+- **Ora** - Elegant terminal spinners
+- **Semantic Release** - Automated versioning and npm publishing
+
+## Development
+
+### Prerequisites
+
+- [Bun](https://bun.sh/) (recommended) or Node.js 18+
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/himanshuchandola/himanshuchandola-cli.git
+cd himanshuchandola-cli
+
+# Install dependencies
+bun install
+
+# Run in development mode
+bun run dev
+
+# Build
+bun run build
+
+# Test
+bun test
+
+# Lint
+bun run lint
+```
+
+### Scripts
+
+- `bun run dev` - Watch mode with auto-rebuild
+- `bun run build` - Build for production
+- `bun test` - Run tests
+- `bun run type-check` - TypeScript type checking
+- `bun run lint` - Lint code with Biome
+- `bun run format` - Format code with Biome
+
+## Project Structure
+
+```
+himanshuchandola-cli/
+├── src/
+│   ├── index.ts              # CLI entry point
+│   ├── config/
+│   │   └── personal.ts       # Personal data configuration
+│   ├── modules/
+│   │   ├── banner.ts         # Animated ASCII banner
+│   │   ├── menu.ts           # Interactive menu system
+│   │   └── card.ts           # Terminal card display
+│   ├── utils/
+│   │   ├── flags.ts          # CLI flag parsing
+│   │   ├── loader.ts         # Dynamic module loading
+│   │   └── open.ts           # Safe URL opening
+│   └── types/
+│       └── index.ts          # TypeScript type definitions
+├── tests/                    # Test files
+├── docs/                     # Documentation
+├── .github/workflows/        # CI/CD workflows
+└── package.json
+```
+
+## Documentation
+
+- [Development Guide](./docs/DEVELOPMENT.md)
+- [Testing Guide](./docs/TESTING.md)
+- [Contributing Guidelines](./docs/CONTRIBUTING.md)
+
+## Automated Publishing
+
+This project uses semantic-release for automated versioning and npm publishing. Commits following the [Conventional Commits](https://www.conventionalcommits.org/) specification will trigger automated releases.
+
+### Commit Message Format
+
+- `feat(scope): message` - Minor version bump
+- `fix(scope): message` - Patch version bump
+- `feat(scope)!: message` - Major version bump (breaking change)
+- `docs(scope): message` - No version bump
+- `chore(scope): message` - No version bump
+
+Valid scopes: cli, config, deps, ci, types, utils, banner, menu, card, release
+
+## License
+
+This project is [MIT](./LICENSE) licensed.
+
+## Author
+
+**Himanshu Chandola**
+
+- Portfolio: [himanshuchandola.dev](https://himanshuchandola.dev)
+- GitHub: [@himanshuchandola](https://github.com/himanshuchandola)
+- LinkedIn: [himanshuchandola](https://www.linkedin.com/in/himanshuchandola/)
+- Twitter: [@himanshuistaken](https://x.com/himanshuistaken)

package/dist/index.js

@@ -0,0 +1,291 @@
+#!/usr/bin/env node
+
+// src/config/personal.ts
+var personalConfig = {
+  name: "Himanshu Chandola",
+  role: "Software Engineer",
+  company: "Exiliensoft Consulting Services",
+  portfolio: "https://himanshuchandola.dev",
+  links: {
+    github: "https://github.com/himanshuchandola",
+    linkedin: "https://www.linkedin.com/in/himanshuchandola/",
+    peerlist: "https://peerlist.io/himanshuhere",
+    twitter: "https://x.com/himanshuistaken"
+  }
+};
+
+// src/modules/banner.ts
+import chalk from "chalk";
+
+// src/utils/loader.ts
+async function loadModule(moduleName) {
+  try {
+    const module = await import(moduleName);
+    return module.default || module;
+  } catch (_error) {
+    throw new Error(`Failed to load module: ${moduleName}`);
+  }
+}
+
+// src/modules/banner.ts
+var bannerColors = [
+  chalk.hex("#667eea"),
+  // Purple
+  chalk.hex("#764ba2"),
+  // Deep purple
+  chalk.hex("#5b86e5"),
+  // Blue
+  chalk.hex("#36d1dc"),
+  // Cyan
+  chalk.hex("#667eea")
+  // Back to purple
+];
+async function animateBanner(text, cycles = 2, delay = 100) {
+  for (let i = 0; i < cycles * bannerColors.length; i++) {
+    console.clear();
+    const colorFn = bannerColors[i % bannerColors.length];
+    if (colorFn) {
+      console.log(colorFn(text));
+    }
+    await new Promise((resolve) => setTimeout(resolve, delay));
+  }
+}
+async function showBanner(skipAnimation) {
+  if (skipAnimation) {
+    return;
+  }
+  try {
+    const figletModule = await loadModule("figlet");
+    const bannerText = figletModule.textSync("Hello There!", {
+      font: "Slant",
+      horizontalLayout: "default",
+      verticalLayout: "default"
+    });
+    await animateBanner(bannerText, 2, 100);
+  } catch (_error) {
+    console.log(chalk.bold.hex("#667eea")("\n=== Hello There! ===\n"));
+  }
+}
+
+// src/modules/card.ts
+import boxen from "boxen";
+import chalk2 from "chalk";
+function createCard() {
+  const name = chalk2.bold.hex("#667eea")(personalConfig.name);
+  const role = chalk2.hex("#a8b2d1")(`${personalConfig.role} @ ${personalConfig.company}`);
+  const tagline = chalk2.hex("#8892b0")("Building elegant solutions, one line at a time");
+  const portfolio = chalk2.hex("#64ffda")(personalConfig.portfolio);
+  const github = chalk2.hex("#64ffda")(personalConfig.links.github);
+  const linkedin = chalk2.hex("#64ffda")(personalConfig.links.linkedin);
+  const peerlist = chalk2.hex("#64ffda")(personalConfig.links.peerlist);
+  const twitter = chalk2.hex("#64ffda")(personalConfig.links.twitter);
+  const width = Math.min(80, Math.max(40, (process.stdout.columns || 80) - 10));
+  const card = boxen(
+    [
+      `${name}`,
+      `${tagline}`,
+      "",
+      `${role}`,
+      "",
+      `${chalk2.hex("#a8b2d1")("Portfolio")}  ${portfolio}`,
+      `${chalk2.hex("#a8b2d1")("GitHub")}     ${github}`,
+      `${chalk2.hex("#a8b2d1")("LinkedIn")}   ${linkedin}`,
+      `${chalk2.hex("#a8b2d1")("Peerlist")}   ${peerlist}`,
+      `${chalk2.hex("#a8b2d1")("Twitter")}    ${twitter}`
+    ].join("\n"),
+    {
+      padding: 1,
+      margin: 1,
+      borderStyle: "double",
+      borderColor: "#667eea",
+      width
+    }
+  );
+  return card;
+}
+function showCard() {
+  console.log(chalk2.hex("#8892b0")("\n Welcome to my interactive cli digital space\n"));
+  console.log(createCard());
+}
+
+// src/utils/open.ts
+import open from "open";
+async function safeOpen(url) {
+  try {
+    await open(url);
+  } catch (_error) {
+    console.log(`
+Couldn't open automatically. Here's the link:
+${url}
+`);
+  }
+}
+
+// src/modules/menu.ts
+var menuChoices = [
+  { name: "\u2192 Visit Portfolio - Check out my work and projects", value: "portfolio" },
+  { name: "\u2192 GitHub Profile - Explore my open source contributions", value: "github" },
+  { name: "\u2192 LinkedIn - Let's connect professionally", value: "linkedin" },
+  { name: "\u2192 Peerlist - View my professional timeline", value: "peerlist" },
+  { name: "\u2192 Twitter/X - Follow for tech insights", value: "twitter" },
+  { name: "\u2190 Exit", value: "exit" }
+];
+var destinationUrls = {
+  portfolio: personalConfig.portfolio,
+  github: personalConfig.links.github,
+  linkedin: personalConfig.links.linkedin,
+  peerlist: personalConfig.links.peerlist,
+  twitter: personalConfig.links.twitter
+};
+var loadingMessages = {
+  portfolio: "Loading portfolio...",
+  github: "Opening GitHub profile...",
+  linkedin: "Connecting to LinkedIn...",
+  peerlist: "Loading Peerlist profile...",
+  twitter: "Opening Twitter/X..."
+};
+async function showRedirectLoader(message, url) {
+  const ora = await loadModule("ora");
+  const cliSpinners = await loadModule("cli-spinners");
+  const loader = ora({
+    text: message,
+    spinner: cliSpinners.dots,
+    color: "magenta"
+  }).start();
+  setTimeout(async () => {
+    loader.succeed(message);
+    await safeOpen(url);
+  }, 1200);
+}
+async function showMenu() {
+  const inquirer = await loadModule("inquirer");
+  const ora = await loadModule("ora");
+  const cliSpinners = await loadModule("cli-spinners");
+  const menuLoader = ora({
+    text: "Initializing menu...",
+    spinner: cliSpinners.dots,
+    color: "magenta"
+  }).start();
+  setTimeout(() => {
+    menuLoader.stop();
+    const questions = [
+      {
+        type: "rawlist",
+        name: "action",
+        message: "What would you like to explore?",
+        choices: menuChoices
+      }
+    ];
+    inquirer.prompt(questions).then(async (answers) => {
+      const action = answers.action;
+      if (action === "exit") {
+        console.log("\u{1F44B} Thanks for stopping by\u2014see you around!");
+        return;
+      }
+      const url = destinationUrls[action];
+      const message = loadingMessages[action];
+      if (url && message) {
+        await showRedirectLoader(message, url);
+      }
+    }).catch((error) => {
+      if (error.message?.includes("SIGINT")) {
+        console.log("\u270B Caught Ctrl+C. Take care and have a great day!");
+      } else {
+        console.log("Prompt closed. Until next time! \u{1F44B}");
+      }
+      process.exitCode = 0;
+    });
+  }, 900);
+}
+
+// src/utils/flags.ts
+function parseFlags(argv2) {
+  const flags2 = {
+    help: false,
+    noAnim: false
+  };
+  for (const arg of argv2) {
+    if (arg === "--help" || arg === "-h") {
+      flags2.help = true;
+    } else if (arg === "--no-anim") {
+      flags2.noAnim = true;
+    } else if (arg.startsWith("--open=")) {
+      const value = arg.slice(7);
+      if (value === "portfolio" || value === "github" || value === "linkedin" || value === "peerlist" || value === "twitter") {
+        flags2.open = value;
+      }
+    }
+  }
+  return flags2;
+}
+function showHelp() {
+  console.log(`
+Usage: himanshuchandola [options]
+
+Options:
+  --open=portfolio|github|linkedin|peerlist|twitter   Open a link directly and exit
+  --no-anim                                            Skip banner animation
+  -h, --help                                           Show this help
+`);
+}
+
+// src/index.ts
+var isCI = process.env.CI === "true" || process.env.CI === "1";
+var isInteractive = process.stdin.isTTY && process.stdout.isTTY;
+var argv = process.argv.slice(2);
+var flags = parseFlags(argv);
+var destinationUrls2 = {
+  portfolio: personalConfig.portfolio,
+  github: personalConfig.links.github,
+  linkedin: personalConfig.links.linkedin,
+  peerlist: personalConfig.links.peerlist,
+  twitter: personalConfig.links.twitter
+};
+async function main() {
+  if (flags.help) {
+    showHelp();
+    process.exit(0);
+  }
+  if (flags.open && flags.open !== "exit") {
+    const url = destinationUrls2[flags.open];
+    if (url) {
+      await safeOpen(url);
+      process.exit(0);
+    }
+  }
+  if (!isInteractive) {
+    console.log("\nQuick links:");
+    console.log(`- Portfolio: ${personalConfig.portfolio}`);
+    console.log(`- GitHub:    ${personalConfig.links.github}`);
+    console.log(`- LinkedIn:  ${personalConfig.links.linkedin}`);
+    console.log(`- Peerlist:  ${personalConfig.links.peerlist}`);
+    console.log(`- Twitter:   ${personalConfig.links.twitter}
+`);
+    process.exit(0);
+  }
+  process.on("SIGTERM", () => {
+    console.log("\u270B Received SIGTERM. Bye!");
+    process.exit(0);
+  });
+  process.on("SIGINT", () => {
+    console.log("\n\u270B Caught Ctrl+C. Take care and have a great day!");
+    process.exit(0);
+  });
+  try {
+    await showBanner(flags.noAnim || isCI);
+    showCard();
+    await showMenu();
+  } catch (error) {
+    if (error instanceof Error && error.message?.includes("SIGINT")) {
+      console.log("\u270B Caught Ctrl+C. Take care and have a great day!");
+      process.exitCode = 0;
+    } else {
+      console.log("Prompt closed. Until next time! \u{1F44B}");
+      process.exitCode = 0;
+    }
+  }
+}
+main().catch((error) => {
+  console.error("An error occurred:", error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "himanshuchandola",
+  "version": "1.0.0",
+  "description": "Interactive CLI portfolio for Himanshu Chandola - A delightful terminal experience",
+  "type": "module",
+  "bin": {
+    "himanshuchandola": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "prepare": "husky",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "terminal",
+    "interactive",
+    "portfolio",
+    "developer-portfolio",
+    "himanshuchandola",
+    "cli-app"
+  ],
+  "author": {
+    "name": "Himanshu Chandola",
+    "url": "https://himanshuchandola.dev"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/himanshuchandola/himanshuchandola-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/himanshuchandola/himanshuchandola-cli/issues"
+  },
+  "homepage": "https://github.com/himanshuchandola/himanshuchandola-cli#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "cli-spinners": "^3.3.0",
+    "figlet": "^1.9.4",
+    "inquirer": "^13.1.0",
+    "open": "^11.0.0",
+    "ora": "^9.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.11",
+    "@commitlint/cli": "^20.3.0",
+    "@commitlint/config-conventional": "^20.3.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.2",
+    "@types/figlet": "^1.7.0",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^25.0.3",
+    "@vitest/coverage-v8": "^4.0.16",
+    "husky": "^9.1.7",
+    "semantic-release": "^25.0.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  }
+}