MCPcopy Index your code
hub / github.com/Ansh-Vortex/Readme-Maker

github.com/Ansh-Vortex/Readme-Maker @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
157 symbols 401 edges 70 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

📝 README.md Maker

Typing SVG

GitHub stars GitHub forks GitHub issues Made with Love

The ultimate tool to create stunning GitHub profile READMEs — no coding required!

🚀 Try It Now⭐ Star This Repo🐛 Report Bug


✨ Features

Feature Description
🎨 Live Preview See your README update in real-time as you customize
📊 GitHub Stats Add GitHub stats, streak, and top languages cards
🛠️ Tech Stack Choose from 50+ languages, frameworks, and tools with beautiful badges
🐍 Snake Animation Include the famous contribution snake animation
🏆 Trophies Display your GitHub achievement trophies
📈 Activity Graph Show your contribution activity graph
💭 Dev Quotes Add inspirational developer quotes with theme options
🔗 Social Links GitHub, LinkedIn, Twitter, Instagram, Telegram, YouTube & more
💼 Projects Showcase your featured projects with beautiful cards
Support Section Buy Me a Coffee & Ko-fi integration
🔐 GitHub OAuth Sign in with GitHub for accurate stats
📱 Responsive Works perfectly on all devices

🖼️ Preview

Preview


🚀 Tech Stack

Next.js TypeScript Tailwind CSS Framer Motion NextAuth.js


🔓 Source Code

⭐ Source code will be revealed at 100 stars! ⭐

Help us reach the goal by starring this repository!

Star this repo

Current Progress:

Stars / 100


📋 How to Use

  1. Sign in with your GitHub account
  2. Fill in your details (username, bio, skills, etc.)
  3. Toggle the features you want (stats, snake, trophies, etc.)
  4. Preview your README in real-time
  5. Copy or Download your generated README.md
  6. Paste it into your GitHub profile repository

🤝 Contributing

Contributions are welcome once the source code is released!

In the meantime, you can: - ⭐ Star this repository - 🐛 Report bugs via Issues - 💡 Suggest features via Issues


☕ Support

If you find this project helpful, consider supporting me:

Buy Me A Chai


👨‍💻 Developer

Ansh

### Ansh

Full Stack Developer | Open Source Enthusiast

Instagram Telegram GitHub


📄 License

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


Made with ❤️ by Ansh

Star this repo if you found it helpful!

Extension points exported contracts — how you extend this code

FormSectionProps (Interface)
(no doc)
src/components/generator/form-section.tsx
Badge (Interface)
(no doc)
src/lib/repo-types.ts
GenerateRequest (Interface)
(no doc)
src/app/api/generate-readme/route.ts
ReadmeState (Interface)
(no doc)
src/hooks/use-readme-store.ts
GeneratorProps (Interface)
(no doc)
src/components/generator/index.tsx
Screenshot (Interface)
(no doc)
src/lib/repo-types.ts
RepoReadmeState (Interface)
(no doc)
src/hooks/use-repo-readme-store.ts
Repo (Interface)
(no doc)
src/components/repo-generator/repo-selector.tsx

Core symbols most depended-on inside this repo

cn
called by 41
src/lib/utils.ts
generateMarkdownInstant
called by 31
src/hooks/use-repo-readme-store.ts
generateSkillIconsRows
called by 7
src/lib/generator.ts
updateStat
called by 6
src/components/generator/sections/stats.tsx
debouncedGenerateMarkdown
called by 5
src/hooks/use-readme-store.ts
generateReadme
called by 4
src/lib/generator.ts
generateSkillIconsStyle
called by 3
src/lib/generator.ts
generateShieldBadges
called by 3
src/lib/generator.ts

Shape

Function 130
Interface 27

Languages

TypeScript100%

Modules by API surface

src/components/ui/select.tsx10 symbols
src/components/ui/dialog.tsx10 symbols
src/lib/repo-types.ts8 symbols
src/lib/generator.ts6 symbols
src/components/repo-generator/repo-analyzer.tsx6 symbols
src/components/repo-generator/index.tsx6 symbols
src/components/repo-generator/ai-assistant.tsx6 symbols
src/lib/types.ts5 symbols
src/components/repo-generator/repo-selector.tsx5 symbols
src/components/generator/sections/skills.tsx5 symbols
src/components/ui/tooltip.tsx4 symbols
src/components/ui/tabs.tsx4 symbols

For agents

$ claude mcp add Readme-Maker \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact