codewithgarry/BEGINNER-GUIDE.md

Girish Sharma's NPX business card - DevOps Engineer & Cloud Architect - Connect with me directly via terminal!

# 🚀 CodeWithGary NPX Card - Beginner's Guide

## What is an NPX Card?
An NPX card is an interactive business card that runs in your computer's terminal/command prompt. It's a modern, tech-savvy way to share contact information!

## 🎯 Quick Start (For Everyone!)

### Option 1: Terminal Version (Recommended)
```bash
npx codewithgarry
```
**That's it!** This single command will show you my interactive business card.

### Option 2: Web Version (No Installation Required)
If you don't have Node.js or prefer not to use the terminal:
- Open `web-version.html` in any web browser
- Or visit: [your-website.com/card](your-website.com/card) (when hosted)

## 🤔 "I'm New to This" - No Problem!

### What is NPX?
- NPX is a tool that comes with Node.js
- It lets you run programs without installing them permanently
- Think of it like a "try before you buy" for software

### What is a Terminal/Command Prompt?
- **Windows**: Search for "Command Prompt" or "PowerShell"
- **Mac**: Search for "Terminal" in Spotlight
- **Linux**: Usually Ctrl+Alt+T opens the terminal

## 📥 First Time Setup (Only if needed)

### Do You Have Node.js?
Test by opening terminal and typing:
```bash
node --version
```

If you see a version number (like `v18.17.0`), you're ready! Skip to the Quick Start.

### Installing Node.js (if needed)
1. **Go to**: [nodejs.org](https://nodejs.org)
2. **Download**: The LTS (Long Term Support) version
3. **Install**: Follow the installer instructions
4. **Restart**: Your terminal/command prompt
5. **Test**: Type `node --version` to confirm

## 🎮 How to Use My NPX Card

1. **Open your terminal/command prompt**
2. **Type**: `npx codewithgarry`
3. **Press Enter**
4. **Navigate**: Use arrow keys to select options
5. **Press Enter**: To open links/send emails

## 🔧 Troubleshooting

### "Command not found" error?
- Install Node.js from [nodejs.org](https://nodejs.org)
- Restart your terminal after installation

### "Permission denied" error?
- **Windows**: Try running as Administrator
- **Mac/Linux**: You might need to use `sudo` (not recommended for npx)

### Still not working?
- Use the web version: `web-version.html`
- Email me: gary@codewithgarry.com
- Check [nodejs.org](https://nodejs.org) for help

## 🌟 Why Use the Terminal Version?

- **Interactive**: Navigate with arrow keys
- **Direct actions**: Opens links automatically
- **Cool factor**: Impress tech-savvy friends
- **No browser needed**: Works anywhere Node.js is installed

## 🔗 Alternative Ways to Connect

Can't get the NPX card working? No worries!

### Direct Links:
- **Email**: [gary@codewithgarry.com](mailto:gary@codewithgarry.com)
- **Website**: [codewithgarry.com](https://codewithgarry.com)
- **GitHub**: [github.com/codewithgarry](https://github.com/codewithgarry)
- **Twitter**: [twitter.com/codewithgarry](https://twitter.com/codewithgarry)
- **LinkedIn**: [linkedin.com/in/codewithgarry](https://linkedin.com/in/codewithgarry)
- **YouTube**: [youtube.com/@codewithgarry](https://youtube.com/@codewithgarry)

### QR Code (Add this to your materials):
```
Generate a QR code that points to: https://your-website.com/card
People can scan it with their phones!
```

## 💡 Pro Tips

### For Beginners:
- Start with the web version if you're not comfortable with terminals
- The NPX command works on Windows, Mac, and Linux
- You only need to install Node.js once

### For Developers:
- Check out my GitHub for the source code
- Fork it to create your own NPX card
- Contribute improvements via pull requests

### For Recruiters/Non-Tech People:
- The web version works perfectly in any browser
- No technical knowledge required
- Same information, different presentation

## 🚀 Share This Card

### For Technical Audiences:
"Check out my NPX card! Just run: `npx codewithgarry`"

### For General Audiences:
"Visit my interactive business card: [link to web version]"

### Social Media:
"Meet me in the terminal! 👇
`npx codewithgarry`
Or visit [web version link] 🚀"

---

**Questions?** Reach out anytime!
- 📧 gary@codewithgarry.com
- 🐦 [@codewithgarry](https://twitter.com/codewithgarry)

*Made with ❤️ and lots of ☕*