NepoReadme is a modern, responsive web app that lets developers generate beautiful, customizable GitHub Profile READMEs instantly — no login required.
- ⚡ No Authentication: Start creating your README immediately.
- 🪞 Live Markdown Preview: See updates in real-time.
- 💎 Rich Widgets: GitHub stats, language cards, streak stats, trophies, and visitor counters.
- 🌐 Social Links: Twitter, LinkedIn, Instagram, and personal websites.
- 💾 Easy Export: Copy or download as
README.md. - 📱 Fully Responsive: Optimized for all devices with sleek dark & purple UI.
| Category | Technology |
|---|---|
| Framework | Next.js 15 |
| Styling | TailwindCSS v4 |
| UI Components | shadcn/ui |
| State Management | Zustand |
| Icons | Custom SVG + Lucide React |
| Deployment | Vercel |
- Go to the Editor page.
- Enter your GitHub username.
- Add optional details: bio, links, skills, donation links.
- Enable widgets as needed.
- Preview changes live.
- Copy or download the markdown output.
- 🧮 GitHub Stats Card
- 🧰 Top Languages
- 🔥 Streak Stats
- 🏆 GitHub Trophies
- 👀 Visitor Counter
GPL-3.0 License — see the LICENSE file.
Forks/deployments must retain visible credit to NepoReadme.
- Fork the repo
- Create a branch:
git checkout -b feature/AmazingFeature - Commit:
git commit -m 'Add AmazingFeature' - Push:
git push origin feature/AmazingFeature - Open a Pull Request
If you enjoy NepoReadme:
- ⭐ Star the repo
- 🔁 Share with other developers
- 🧠 Suggest features
- 🐛 Report issues via GitHub Issues