Skip to content

Repository files navigation

Impostor app icon

Impostor

Offline pass-the-phone impostor party game β€” everyone shares a word except the impostors; talk, vote, and unmask them. No login, no internet.

Latest release CI Last commit Conventional Commits License: MIT

β–Ά Play it now

What you can do

  • Play on a single phone β€” no signup, no accounts, fully offline.
  • Choose how many impostors join the round, from 1 up to the table size.
  • Toggle whether impostors get a clue (the word's category) or fly completely blind.
  • Toggle whether impostors know each other or play alone.
  • Pick word categories β€” General, Music, Places β€” 18 words each (54 per language), fully translated in six languages.
  • Hold-to-reveal handoff: each player presses and holds to see their word, then passes the phone on.
  • A random player is chosen to start the conversation each round.
  • Vote in-app and get a win/lose reveal showing who the impostors were.
  • Synthesized audio cues β€” no audio files to download, works offline.
  • Install it as a PWA on any device.

How to start

  1. Open Impostor on any phone.
  2. Set the number of players and impostors, pick categories, and tweak the toggles.
  3. Pass the phone around to reveal words, talk it out, then vote.

Install on your device

Open endika.github.io/Impostor in Chrome, Edge or Safari and use "Add to Home Screen" (mobile) or "Install" (desktop). Behaves like a native app and works fully offline by design.

Languages

Catalan, English, Spanish, Basque, Galician, Valencian (ca, en, es, eu, gl, va).

Privacy

No login, no accounts, no backend. Everything runs in your browser and stays on your device. No analytics, no tracking, no cookies (except your language preference).


For developers

Open-source, MIT licensed. PRs welcome.

Stack β€” React 19, Vite, TypeScript (strict), Tailwind CSS 4, vite-plugin-pwa, i18next, uuidv7, Vitest.

Architecture β€” Hexagonal (domain β†’ application β†’ presentation). Tests use in-memory fakes β€” no mocks.

Local dev

git clone git@github.com:Endika/Impostor.git
cd impostor
npm install
npm run dev

Commands

Command Description
npm run dev Start the dev server
npm run build Production build (tsc -b && vite build)
npm test Run tests once
npm run lint ESLint (zero warnings)
npm run typecheck TypeScript type check

CI runs lint, typecheck, tests, and the production build on every PR.

About

🎭 Offline pass-the-phone impostor party game β€” PWA, 6 languages, synthesized audio, no backend, no internet.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages