GitHub - tonycletus/ghread: Generate beautiful GitHub README profiles instantly with a simple command. TypeScript CLI tool with interactive setup, multiple themes, and auto-updating stats.

# Generate your README instantly (no installation needed!)
npx ghread init

npm install -g ghread
ghread init

$ npx ghread init

Welcome to ghread! Let's create your GitHub profile

? What's your name? Tony Cletus
? What's your GitHub username? tonycletus
? What's your professional title? Full Stack Developer
? Write a short bio about yourself: Passionate developer building amazing things
? Your Twitter handle (without @): iamtonycletus
? Your LinkedIn username: tonycletus
? Your email: hello@tonycletus.com
? Your website URL: https://tonycletus.com
? Choose a theme: Tokyo Night

README.md generated successfully!

Next steps:
1. Review your README.md file
2. Commit and push to your GitHub profile repository
3. Your profile will be live at github.com/tonycletus

# Hi there

**Welcome to my corner of the digital world!**

I'm **Tony Cletus**, and this profile is a glimpse into my journey as a Full Stack Developer.

---

### About Me
- **Passion**: Passionate developer building amazing things
- **Growth**: Lifelong learner, exploring tech and coding every day  
- **Collaboration**: Open to open-source and research collaborations  
- **Focus**: Tech, AI, coding, and privacy-aware systems  
- **Beyond Code**: Traveler, family-oriented, and driven by curiosity  
- **Fun fact**: I drink Garri, not Coffee  

Connect with me:  
[![Twitter Badge](https://img.shields.io/badge/-@iamtonycletus-1DA1F2?style=flat&logo=twitter&logoColor=white)](https://twitter.com/iamtonycletus)  
[![LinkedIn Badge](https://img.shields.io/badge/-Tony%20Cletus-0077B5?style=flat&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/tonycletus)  
[![Email Badge](https://img.shields.io/badge/-hello@tonycletus.com-EA4335?style=flat&logo=gmail&logoColor=white)](mailto:hello@tonycletus.com)
[![Website Badge](https://img.shields.io/badge/-Website-000000?style=flat&logo=About.me&logoColor=white)](https://tonycletus.com)

---

### GitHub Stats (auto-updating)
![Tony Cletus's GitHub stats](https://github-readme-stats.vercel.app/api?username=tonycletus&show_icons=true&count_private=true&theme=tokyonight)

![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=tonycletus&layout=compact&count_private=true&theme=tokyonight)

![GitHub Streak](https://streak-stats.demolab.com?user=tonycletus&theme=tokyonight&hide_border=false)

---

### Contribution Graph
![Contribution Graph](https://github-readme-activity-graph.vercel.app/graph?username=tonycletus&theme=tokyonight&hide_border=false)

---

*"Let's change the world one code at a time."*

import { generateReadme, GhreadConfig } from 'ghread';

const config: GhreadConfig = {
  name: 'Tony Cletus',
  username: 'tonycletus',
  title: 'Full Stack Developer',
  bio: 'Passionate developer building amazing things',
  twitter: 'iamtonycletus',
  linkedin: 'tonycletus',
  email: 'hello@tonycletus.com',
  website: 'https://tonycletus.com',
  theme: 'tokyonight'
};

// Generate README
await generateReadme(config);

{
  "name": "Tony Cletus",
  "username": "tonycletus",
  "title": "Full Stack Developer",
  "bio": "Passionate developer building innovative solutions",
  "twitter": "iamtonycletus",
  "linkedin": "tonycletus",
  "email": "hello@tonycletus.com",
  "website": "https://tonycletus.com",
  "github": "tonycletus",
  "stackoverflow": "123456",
  "theme": "tokyonight",
  "sections": {
    "aboutMe": true,
    "githubStats": true,
    "topLanguages": true,
    "streak": true,
    "contributionGraph": true,
    "achievementGallery": false,
    "techTools": false,
    "blogArticles": false,
    "featuredProjects": false,
    "funSections": false,
    "realTimeStats": false
  }
}

# Clone the repo
git clone https://github.com/tonycletus/ghread.git
cd ghread

# Install dependencies
npm install

# Build with tsup (powered by esbuild)
npm run build

# Link for local development
npm link

# Watch mode for development
npm run dev