himanshuchandola 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +19 -142
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,171 +1,44 @@
1
1
  # himanshuchandola-cli
2
2
 
3
- Interactive CLI portfolio for Himanshu Chandola - A modern terminal experience built with TypeScript.
3
+ Interactive CLI portfolio for Himanshu Chandola - A delightful terminal experience built with TypeScript.
4
4
 
5
- [![npm version](https://img.shields.io/npm/v/himanshuchandola.svg)](https://www.npmjs.com/package/himanshuchandola)
6
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
- [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
5
+ [![npm version](https://img.shields.io/npm/v/himanshuchandola.svg?style=flat-square)](https://www.npmjs.com/package/himanshuchandola)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
7
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg?style=flat-square)](https://www.typescriptlang.org/)
8
8
 
9
- ## Overview
9
+ <br>
10
10
 
11
- 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.
11
+ <div align="center">
12
+ <img src="./assets/demo_cli.gif" alt="himanshuchandola-cli demo" width="600" />
13
+ </div>
12
14
 
13
- ## Installation
15
+ <br>
14
16
 
15
- ### Run without installing
17
+ ## 🚀 Quick Start
16
18
 
19
+ ### Run without installing
17
20
  ```bash
18
21
  npx himanshuchandola
19
22
  ```
20
23
 
21
24
  ### Install globally
22
-
23
25
  ```bash
24
- npm install -g himanshuchandola
26
+ npm i -g himanshuchandola
25
27
  ```
26
28
 
27
- Then run:
29
+ The global binary is exposed as `himanshuchandola` and now you can run as a command:
28
30
 
29
31
  ```bash
30
32
  himanshuchandola
31
33
  ```
32
34
 
33
- ## Usage
34
-
35
- ```bash
36
- himanshuchandola [options]
37
- ```
38
-
39
- ### Options
40
-
41
- - `--open=<destination>` - Open a destination directly (portfolio, github, linkedin, peerlist, twitter)
42
- - `--no-anim` - Skip the animated banner
43
- - `-h, --help` - Show help message
44
-
45
- ### Examples
46
-
47
- ```bash
48
- # Open GitHub directly
49
- himanshuchandola --open=github
50
-
51
- # Skip animation
52
- himanshuchandola --no-anim
53
-
54
- # Show help
55
- himanshuchandola --help
56
- ```
57
-
58
- ## Features
59
-
60
- - Animated ASCII banner with color cycling
61
- - Beautiful terminal card with personal information
62
- - Interactive numbered menu for navigation
63
- - CLI flags for direct navigation and animation control
64
- - Graceful fallbacks for non-TTY environments
65
- - TypeScript with strict mode
66
- - Comprehensive test coverage
67
- - Automated versioning and publishing with semantic-release
68
-
69
- ## Tech Stack
70
-
71
- - **TypeScript** - Type-safe development with strict mode
72
- - **tsup** - Fast TypeScript bundler
73
- - **Biome** - Fast linter and formatter
74
- - **Vitest** - Unit testing framework
75
- - **Inquirer** - Interactive command-line prompts
76
- - **Chalk** - Terminal string styling
77
- - **Boxen** - Terminal boxes
78
- - **Figlet** - ASCII art text
79
- - **Ora** - Elegant terminal spinners
80
- - **Semantic Release** - Automated versioning and npm publishing
81
-
82
- ## Development
83
-
84
- ### Prerequisites
85
-
86
- - [Bun](https://bun.sh/) (recommended) or Node.js 18+
87
-
88
- ### Setup
89
-
90
- ```bash
91
- # Clone the repository
92
- git clone https://github.com/himanshuchandola/himanshuchandola-cli.git
93
- cd himanshuchandola-cli
94
-
95
- # Install dependencies
96
- bun install
97
-
98
- # Run in development mode
99
- bun run dev
100
-
101
- # Build
102
- bun run build
103
-
104
- # Test
105
- bun test
106
-
107
- # Lint
108
- bun run lint
109
- ```
110
-
111
- ### Scripts
112
-
113
- - `bun run dev` - Watch mode with auto-rebuild
114
- - `bun run build` - Build for production
115
- - `bun test` - Run tests
116
- - `bun run type-check` - TypeScript type checking
117
- - `bun run lint` - Lint code with Biome
118
- - `bun run format` - Format code with Biome
119
-
120
- ## Project Structure
121
-
122
- ```
123
- himanshuchandola-cli/
124
- ├── src/
125
- │ ├── index.ts # CLI entry point
126
- │ ├── config/
127
- │ │ └── personal.ts # Personal data configuration
128
- │ ├── modules/
129
- │ │ ├── banner.ts # Animated ASCII banner
130
- │ │ ├── menu.ts # Interactive menu system
131
- │ │ └── card.ts # Terminal card display
132
- │ ├── utils/
133
- │ │ ├── flags.ts # CLI flag parsing
134
- │ │ ├── loader.ts # Dynamic module loading
135
- │ │ └── open.ts # Safe URL opening
136
- │ └── types/
137
- │ └── index.ts # TypeScript type definitions
138
- ├── tests/ # Test files
139
- ├── docs/ # Documentation
140
- ├── .github/workflows/ # CI/CD workflows
141
- └── package.json
142
- ```
143
-
144
- ## Documentation
35
+ ## 📖 Documentation
145
36
 
146
37
  - [Development Guide](./docs/DEVELOPMENT.md)
147
38
  - [Testing Guide](./docs/TESTING.md)
148
39
  - [Contributing Guidelines](./docs/CONTRIBUTING.md)
149
40
 
150
- ## Automated Publishing
151
-
152
- 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.
153
-
154
- ### Commit Message Format
155
-
156
- - `feat(scope): message` - Minor version bump
157
- - `fix(scope): message` - Patch version bump
158
- - `feat(scope)!: message` - Major version bump (breaking change)
159
- - `docs(scope): message` - No version bump
160
- - `chore(scope): message` - No version bump
161
-
162
- Valid scopes: cli, config, deps, ci, types, utils, banner, menu, card, release
163
-
164
- ## License
165
-
166
- This project is [MIT](./LICENSE) licensed.
167
-
168
- ## Author
41
+ ## 👨‍💻 Author
169
42
 
170
43
  **Himanshu Chandola**
171
44
 
@@ -173,3 +46,7 @@ This project is [MIT](./LICENSE) licensed.
173
46
  - GitHub: [@himanshuchandola](https://github.com/himanshuchandola)
174
47
  - LinkedIn: [himanshuchandola](https://www.linkedin.com/in/himanshuchandola/)
175
48
  - Twitter: [@himanshuistaken](https://x.com/himanshuistaken)
49
+
50
+ ## 📄 License
51
+
52
+ This project is [MIT](./LICENSE) licensed.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "himanshuchandola",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "description": "Interactive CLI portfolio for Himanshu Chandola - A delightful terminal experience",
5
5
  "type": "module",
6
6
  "bin": {