A community-driven platform for documenting, discovering, and learning from real-world software bugs.
Every developer has been there.
You find an error you've never seen before. You spend hours searching for the cause. You finally fix it.
Then the solution disappears into a private chat, a browser tab, or your terminal history.
Bugged exists to change that.
Bugged is an open-source platform where developers can document real bugs, explain what caused them, share their fixes, and help the next developer who encounters the same problem.
Don't just fix the bug. Document it.
Create detailed bug reports with everything another developer needs to understand the problem.
- What happened
- Error message
- Technology stack
- Root cause
- Failed attempts
- Solution
- Lessons learned
Search through real-world developer problems instead of starting from zero every time.
Browse bugs by technologies such as:
Laravel PHP React Next.js Vue Node.js Python WordPress MySQL Docker Linux
Companies can create profiles, share their engineering experiences, and build a presence within the developer community.
Bugged turns individual debugging experiences into shared knowledge.
- Public bug posts
- Structured bug documentation
- Technology & stack tagging
- Search & discovery
- Developer profiles
- Company profiles
- Community activity
- Streaks
- Collaboration
- Public discussions
- More community features
- More developer integrations
Bugged is built with modern web technologies:
| Technology | Purpose |
|---|---|
| Laravel | Backend framework |
| PHP | Application logic |
| React | Frontend |
| MySQL | Database |
| Tailwind CSS | UI |
| Vite | Frontend tooling |
Before running Bugged locally, make sure you have:
- PHP 8.x+
- Composer
- Node.js 18+
- npm
- MySQL
- Git
git clone https://github.com/bugged-cc/bugged.git
cd buggedcomposer install
npm installcp .env.example .envUpdate your .env file with your database credentials.
php artisan key:generatephp artisan migratenpm run buildFor development:
npm run devphp artisan serveBugged should now be available at:
http://127.0.0.1:8000
Bugged is open source, and contributions are welcome.
There are many ways to contribute:
- 🐛 Fix a bug
- ✨ Build a feature
- 🎨 Improve the UI
- 📚 Improve documentation
- 🔍 Improve search
- ⚡ Improve performance
- 💡 Suggest an idea
- 🧪 Add tests
- 🔌 Build integrations
Fork
↓
Create a branch
↓
Make your changes
↓
Test
↓
Commit
↓
Open a Pull Request
Please read CONTRIBUTING.md before submitting a pull request.
That's what we're here for.
If you find a problem with Bugged, open an issue and include:
- Clear description
- Steps to reproduce
- Expected behavior
- Actual behavior
- Browser / environment
- Screenshots
- Relevant logs or errors
Please do not include sensitive information such as passwords, API keys, or private data.
If you discover a security vulnerability, please do not create a public GitHub issue.
Instead, report it privately so the issue can be investigated responsibly.
See SECURITY.md for our security policy.
bugged/
├── app/
├── bootstrap/
├── config/
├── database/
├── public/
├── resources/
├── routes/
├── storage/
├── tests/
├── docs/
├── .env.example
├── artisan
├── composer.json
├── package.json
└── README.md
The internet contains millions of solutions to programming problems.
But many of the most useful debugging experiences are never documented.
Bugged aims to build a place where developers can turn those experiences into reusable knowledge.
"I spent 4 hours fixing this."
"I spent 4 hours fixing this.
Here's exactly what happened,
why it happened,
and how I fixed it."
Bugged is built for developers, by developers.
Whether you're:
- 🧑💻 A beginner learning to debug
- 👨💻 An experienced developer
- 🏢 A software company
- 🎓 A student
- 🛠️ An open-source contributor
You are welcome here.
Bugged is released under the MIT License.
See LICENSE for more information.
Document it. Fix it. Share it.
⭐ If you find Bugged useful, consider giving the repository a star.