Claude Code Workshop

A one-hour, hands-on Claude Code workshop you can run for your team. Bundled with a real TodoMVC app so attendees have something concrete to point Claude at — no toy examples, no "imagine if..." Real React, real tests, real PR at the end.

Who it's for

Engineering teams new to Claude Code. Devs who've heard about agentic coding, maybe poked at it for ten minutes, but haven't sat down and spent a focused hour building the muscle. If that's your team, this is for you.

Quick start

1. Clone this repo.
2. cd target/todomvc && npm install — get the wifi-pulling-down-packages bit out of the way before the workshop starts. One minute, saves ten in the room.
3. Open workshop/todomvc/README.md and follow it phase by phase.
4. Lunch. Optional, but recommended.

What's in the box

• target/todomvc/ — the bundled TodoMVC app. React 18 + TS + Vite + Vitest + Zustand. Real tests, persists to localStorage. This is what attendees point Claude at.
• workshop/todomvc/before/ — starter settings.json, placeholder CLAUDE.md, empty hook stub. Phase 2 and 3 walk through replacing these.
• workshop/todomvc/after/ — the finished versions. Drop these in if someone falls behind.
• workshop/todomvc/phases/ — five short markdown files, one per phase. Each is read out loud during the workshop, so they're kept tight.
• workshop/todomvc/README.md — the facilitator plan. Read it once before running the workshop.

Why bundled

So you only clone one repo. No "go fork the upstream and find the right tag, then hope main hasn't drifted." If you're running this for a team, install the dependencies before the workshop starts and you'll never see a wifi-related delay.

Who runs it

Built by Mawla Ltd. Questions: dan@mawla.ie.

License

MIT. See LICENSE. Use it, fork it, run your own version of the workshop. If you ship improvements, a PR back is welcome but not required.