Demo version · English summary
Pocket Mystery
A detective story that fits in your pocket.
Pocket Mystery is an interactive murder-mystery game, played in Polish. There are no multiple-choice menus: you type, in your own words, where you go and whom you question, and an AI game master plays the witnesses and suspects. The solution is hidden. Your job is to reach it before you run out of accusations.
The game itself is in Polish, so below is an English rendering of how one case opens. If you would like to try the game, I can send you a personal link.
Where it comes from
Pocket Mystery is my own project. I write the cases from start to finish: characters, alibis, clues, red herrings and the hidden solution, as well as the rules the game master follows when it runs a conversation. I am a literary translator (more than 120 books translated into Polish) and a content writer and editor, and this game is where my writing meets engineering.
The code was written with an AI coding assistant (Claude Code) under my direction: I decide what the game does and how, I review the changes, and I run the database changes myself.
How it is built
- The solutions to the cases live only on the server and are never sent to the browser.
- The game master (a Claude model) runs the conversation, but whether an accusation is correct is decided by code, not by the model, so the verdict is consistent.
- The state of the investigation (clues found, stages, accusations left) is tracked by the app, not by the model.
- Every move has a recorded cost and the game has limits, so the AI bill stays predictable.
- Next.js, TypeScript, Supabase, the Anthropic API, Vercel. It runs in the browser and as a phone app (PWA).
How a case opens: “Who Ate the Third Fish?”
English rendering of the Polish original. A short, light case: a catered wedding, ten portions of sturgeon, and one that is missing. The excerpt stops before the solution.
Introduction to the case
Welcome to Dworek pod Różą, where yesterday’s wedding of the year took place. Or so social media and the poster in the groom’s pub would have you believe.
You work for the catering company that brought the sturgeon. This morning the newlyweds won’t get out of bed, the bride’s out-of-town relatives are packing in silence, and you are supposed to reconcile the portions. Ten ordered, two served to the newlyweds, seven disposed of, and the invoice still doesn’t add up. One portion is missing: the third one.
Paweł Majzel is a celebrity. Read: he is famous for being famous. He runs a craft-beer pub in Katowice and has just married Berenika Sława, a lovely girl who works at her family’s bistro, younger than he is by about half a lifetime. On the wedding cake the groom flashes his teeth while the bride modestly lurks in the background. The wedding was meant to be glamorous, so the groom insisted on fusion cuisine, though he is closer to an ageing lothario than to a luxury celebrity. Witold, the head chef and owner of your firm, Catering Chochelka, talked him out of it and they settled on a safe Italian menu. Paweł did push through one eccentricity: sturgeon, at the groom’s special request.
The notes of the newlyweds’ first dance (“That’s Just How Maxi Kaz Is” by the T-Rapers from the Vistula) had barely faded when the first stomachs began to ache at dawn. Nobody wants to admit to eating the missing portion. Witold swears he left the plate in the kitchen and even photographed the fancy arrangement. Someone should find out who ate it. First, to check whether that person is alive. Second, to apologise, because if the sturgeon was what half the room suspects, someone is having a very long morning.
You
I go to the kitchen and ask Witold for the list of portions.
Game master
The kitchen gleams like an operating theatre. Damascus-steel knives lie in a perfect row, and over it all reigns Witold in an immaculate white apron. He hands over two sheets of paper as if presenting sheet music.
“Prego, everything black on white. Ten portions ordered, due served to the newlyweds, sette disposed of, here, the protocol with a signature, quarter past midnight. And the eighth, the spare, was on the shelf in cold room number two.”
He opens the cold room, sliding back the bolt. On the shelf stands an empty tray.
“I left at half past midnight, and the portion was intact. I have a photo, a composition degna di un museo. And now? Niente.”
What do you do?
You
I go to the newlyweds and ask how they feel.
Game master
The newlyweds’ suite smells of mint and despair. Paweł lies on the sofa with a hand on his stomach; Berenika sits curled up under a blanket, pale as the tablecloth.
“Stress before family life,” Paweł announces, then winces painfully. “All right. I have an exceptionally sensitive stomach, unaccustomed to plebeian fare. Veronica, darling… no, Berenika, pass me some water.”
Berenika hands him a glass and says quietly:
“We’ve both been the same since dawn. Stomach, nausea, taking turns in the bathroom all morning.”
What do you do?
You
I talk to the MC and ask how he’s feeling.
Game master
In the lobby, at a small table by the window, sits Julian “Kaowiec” Królewski in sunglasses, though the sun barely makes it through the curtains. In front of him are a glass of water and a dry roll with a single modest bite taken out of it.
“How do I feel? Like a superstar after the tour,” he says, forcing a smile. “A migraine, darling, an occupational hazard of artists. I called off the second-day party, there’s no point without an MC, and today I need it dark and quiet.”
He breaks off a crumb of roll and puts it back on the saucer.
What do you do?
… the excerpt stops here so as not to give away the solution.