Every developer knows the feeling:
You ship some code, hit refresh, and boom - an error message stares back at you like itโs written in an alien language. ๐ฝ
You copy-paste it into Google. Open 10 tabs. Jump between Stack Overflow posts from 2014. Still confused. Still frustrated.
That pain is where ErrExplain was born.
Why I Built ErrExplain ๐ค
I joined the Appwrite Sites Hackathon 2025 with a simple goal:
๐ Make error messages easier to understand and easier to share.
Because letโs be honest - debugging should feel like solving puzzles, not running in circles.
What ErrExplain Does ๐
ErrExplain has 3 main superpowers:
- Explains errors in plain English โ No jargon, just clarity.
- Suggests fixes โ Practical, real-world solutions to try right away.
- Generates a shareable link โ So you can send the error analysis to a teammate in seconds.
Basically, itโs like having a helpful debugging buddy who doesnโt roll their eyes when you ask, โBut why isnโt it working?โ ๐
Building It ๐งโ๐ป
The stack that powered ErrExplain:
- Frontend โ Next.js 15, React 19, Tailwind CSS 4
- Backend โ Appwrite Functions + Database, Node.js, node-appwrite
- AI โ Groq (Llama 4 Maverick) via Vercel AI SDK
- Extras โ Zod (validation), Sonner (toasts), Lucide React (icons), Recharts (charts)
- Deployment โ Appwrite Sites ๐
Simple, modern, and fully serverless.
The Journey ๐
ErrExplain didnโt make it to the hackathon winnersโ list, but hereโs what happened instead:
โ 50+ upvotes on Peerlist
โ 600+ views, 150+ visitors, 25+ countries
โ Encouraging feedback from the Vercel AI SDK team, the Appwrite community, and devs on Twitter/X
And honestly? That kind of love felt like a win in itself. ๐
Highlights Iโm Proud Of โจ
- Built in just a few weeks during the hackathon sprint
- First time combining Vercel AI SDK + Appwrite Functions in a real-world project
- Developers actually using it and telling me it saved them time
- Showcased in the Vercel community - which was surreal for me ๐
Whatโs Next ๐ฎ
Iโm excited to keep improving ErrExplain!
This was just version 1.0 - the potential is way bigger.
Final Thoughts โค๏ธ
Building ErrExplain taught me two things:
- Hackathons arenโt only about winning - theyโre about building, learning, and sharing.
- If you solve your own frustration, chances are others will thank you for it too.
So thank you to Appwrite for organizing the hackathon, to Vercel for the amazing AI SDK, and to everyone who supported ErrExplain with upvotes, shares, or feedback. ๐
โ Try ErrExplain here
โ Source Code on GitHub
โ Vercel Community Showcase
โ Follow me on Twitter/X
Hereโs to fewer headaches and clearer errors for all of us. ๐
Top comments (0)