Student Project Showcase logoStudent Project Showcase
← Back to all projects
WebsitesAug 2026

ChuckleBox — Joke Generator Built From a Spec

by Quentin Lee

ChuckleBox — Joke Generator Built From a Spec
Base44AI App BuilderProduct SpecificationState ManagementUI Design

"Press the button. Get a joke. Try not to groan." ChuckleBox is a small app with a big lesson behind it: Quentin didn't ask an AI to *make him something fun*. He wrote it a specification.

His brief opens by casting the model as an expert product designer and developer, then lays the work out in numbered sections. **Core functionality and database:** a local database of jokes, each entry holding a setup, a punchline and a category. **State management:** keep the punchline hidden and reveal it on demand with a smooth transition. **Filtering:** a category bar so users can narrow to one genre. **Visual style:** a bright yellow accent on a soft blue-grey background, a centred layout, one card as the focal point with rounded corners and a drop shadow, bold friendly sans-serif with the setup text larger than the category tag. **Visual anchors:** specific emoji per category. And then — the part almost nobody thinks to write — **exclusions**: no login, no authentication, no social media APIs, just a copy-to-clipboard button.

That structure is how real software briefs are written. Naming a data shape before any interface exists, describing behaviour as state rather than as pictures, and *bounding the scope by saying what not to build* are three habits that take most people years to pick up. Stating exclusions is the most advanced move of the three: it's how you stop a project sprawling.

Then he went past his own brief. The spec called for 20 jokes in three categories — Dad Jokes, Tech Humor and Puns. The live app ships **51 jokes across seven**, because he added Ocean, Hong Kong and Brawl Stars sets himself. The Hong Kong ones are written for people who actually live there: *"Why is the MTR the quietest place in the city?"* And the Ocean category is a quiet callback to the SDG 14 work he'd just finished.

Writing a tight spec and then outgrowing it is exactly the right order to do things in.

More like this

Ready to start building?

Book a free trial class with Harvey.

Enroll