Created a developer excuse generator with 6 situations, 4 tones, and custom excuses

#react #javascript #jokes #opensource

Excusify: A Excuse Generator for Engineering Teams:
We've all been there. The standup starts in three minutes. The bug is still unfixed. The deploy failed. Your PR has been waiting for review for two days. And somehow, "I don't know" doesn't cut it in a professional setting.

Excusify is a tongue-in-cheek solution to a real problem: how to communicate setbacks with confidence, context, and just the right tone. Pick your situation, select your audience, and get a believable, shareable excuse in seconds.

Try it live
View on GitHub (MIT licensed, open source)

The Premise
Engineering moves fast. Things break. Deadlines slip. Deployments fail. Sometimes you need to communicate what happened — and how you say it matters.

Excusify curates 72 hand-written excuses across six common engineering situations and four distinct tones.Every excuse gets its own shareable URL, and there's a seed-based Excuse of the Day that the entire community sees together.

It's lighthearted. It's useful. And it works.

The Six Situations
Every engineer recognizes these:
SituationThe RealityBug Still ExistsIt worked on your machine, didn't it?Missed DeadlineScope creep is real, but you can't say that.Production Went DownYou inherited someone else's mess.PR Not ReviewedFour pings and counting.Deploy FailedThe CI/CD pipeline had other plans.Missed StandupYou were "in deep focus work."

Four Tones for Every Audience
The same situation plays differently depending on who you're talking to:

1. Professional - Measured, forward-looking. For your PM and stakeholders.
2. Chaotic - Honest frustration with a laugh. For your tech lead and peers.
3. Desperate - Raw vulnerability. For your immediate team.
4. Corporate BS - Buzzword-heavy, non-committal. For management and executives.

Each situation × tone combination has a hand-crafted excuse. No filler. All believable.

Sharing Built In
Generated excuses are meant to be shared. Excusify includes multiple export options:

1. Download as PNG - Tweet-ready excuse card via html2canvas
2. Native Share - One-click compose for Twitter, LinkedIn, Slack, and WhatsApp
3. Copy to Clipboard - Pre-formatted for Slack's bold and quote syntax
4. Shareable URL - Every excuse gets a unique link, encoded in the URL parameters
5. Deep Links - Direct sharing to messaging apps

Share it. Send it. Own the situation.

The Little Details That Matter

Favorites & History
Star your best excuses - they persist to localStorage. Your last 10 excuses live in history with a "show all" toggle. Capped storage prevents bloat while keeping your go-to excuses within reach.

Full Keyboard Navigation
Speed matters. Hit Space to generate, C to copy, F to favorite, S/T to switch situation and tone pickers, and ? to reveal the shortcuts overlay. Power users never need to touch the mouse.

Synthesized Sound Feedback
Every generated excuse comes with subtle, synthesized audio feedback. No external sound files — everything is generated in-browser via the Web Audio API. A small UX detail that makes interaction feel snappy.

Excuse of the Day (Seed-Based)
Using a date-based seed, the same excuse generates for every user on the same day. It creates a shared experience: "Did you see today's excuse?" Community inside a joke.

Generational Counter
An all-time counter tracks total excuses generated across all user sessions. It's a completely useless metric — but it somehow feels important.

Run It Locally
Clone and start developing in seconds:

bashgit clone https://github.com/byllzz/excusify.git
cd excusify
npm install
npm run dev

How to Contribute
Found a situation we missed? Thought of a better tone? Want to add translations or improve accessibility?
Good first contributions:

Add new situations to situations.js and excuses.js
Create new tones following the pattern in tones.js
Refine the custom AI excuse templates
Translate excuses to a new language (locale file)
Improve accessibility — ARIA labels, focus management, keyboard shortcuts

Contribution workflow:

bashgit checkout -b feat/your-feature 
git commit -m "feat: your short description" 
git push origin feat/your-feature

Keep PRs focused - one feature or fix per request.

Closing
Excusify is tongue-in-cheek, but it solves a real communication problem: how to own your mistakes with confidence and the right tone for the audience.