El Impostor Party is a social deduction party game where players try to identify the impostor among them. All players except the impostor(s) receive a secret word. Through rounds of giving one-word clues, players must figure out who doesn't know the word while the impostor tries to blend in by listening carefully and adapting.
Perfect for parties, family gatherings, game nights, or any social event!
| Feature | Description |
|---|---|
| Local Multiplayer | Pass the phone around - no internet required |
| 4-30 Players | Scales from small groups to large parties |
| Multiple Impostors | Configure 1-4 impostors for larger games |
| 18 Categories | Animals, food, countries, movies, sports, and more |
| 2000+ Words | Extensive word database in Spanish |
| Beautiful UI | Modern dark theme with smooth animations |
| Haptic Feedback | Tactile responses for an immersive experience |
| Customizable | Set timer duration and number of rounds |
| Privacy First | No ads, no tracking, completely offline |
- Choose number of players (4-30)
- Select number of impostors (1-4)
- Pick a word category
- Set round timer
1. REVEAL ROLES
Pass the phone around. Each player privately sees:
- Civilians: The secret word
- Impostors: "You are the Impostor"
2. GIVE CLUES
Take turns saying ONE word related to the secret word.
The impostor must fake knowing the word!
3. DISCUSS & VOTE
After the clue rounds, discuss and vote to eliminate
the suspected impostor.
4. LAST CHANCE
If caught, the impostor can guess the word to win!
| Team | How to Win |
|---|---|
| Civilians | Successfully vote out all impostors |
| Impostors | Survive until the end OR guess the secret word when caught |
- Give clues that aren't too obvious (the impostor is listening!)
- Watch other players' reactions and hesitations
- Impostors should listen carefully and give vague but plausible clues
| Home | Setup | Role Reveal | Voting |
 |
 |
 |
 |
- Node.js 18+
- npm or yarn
- Expo CLI (
npm install -g expo-cli) - iOS Simulator (macOS) or Android Emulator
# Clone the repository
git clone https://github.com/yourusername/el-impostor-party.git
cd el-impostor-party
# Install dependencies
npm install
# Start development server
npm start# iOS Simulator
npm run ios
# Android Emulator
npm run android
# Web Browser
npm run web
# Physical Device
# Scan QR code with Expo Go app|
Framework
|
Navigation
|
State
|
|
UI/Animation
|
Feedback
|
Icons
|
src/
├── app/ # Expo Router screens
│ ├── index.tsx # Home screen
│ ├── setup.tsx # Game configuration
│ ├── players.tsx # Player registration
│ ├── settings.tsx # App settings
│ └── game/ # Game flow
│ ├── reveal.tsx # Role reveal
│ ├── pass.tsx # Pass phone screen
│ ├── play.tsx # Clue giving phase
│ ├── vote.tsx # Voting phase
│ ├── results.tsx # Round results
│ └── final.tsx # Game end
│
├── components/
│ ├── ui/ # Button, Card, Modal, Input...
│ ├── layout/ # Screen, Header, Container...
│ ├── game/ # PlayerCard, RoleReveal, VoteButton...
│ └── feedback/ # Timer, Toast, LoadingSpinner...
│
├── constants/
│ ├── colors.ts # Color palette
│ ├── theme.ts # Theme tokens
│ └── words.ts # 2000+ words in 18 categories
│
├── hooks/ # useHaptics, useSound, useTimer
├── store/ # Zustand stores (game, settings)
├── types/ # TypeScript definitions
└── utils/ # Helper functions
The game includes 18 categories with 80-150 words each:
| Animals | Food | Countries | Cities |
| Sports | Professions | Movies | Music |
| Home Items | Clothing | Fruits | Vegetables |
| Emotions | Places | Transportation | Famous People |
| Video Games | Brands |
# Install EAS CLI
npm install -g eas-cli
# Login to Expo
eas login
# Build for iOS
eas build --platform ios
# Build for Android
eas build --platform android
# Submit to App Store
eas submit --platform ios
# Submit to Play Store
eas submit --platform androidContributions are welcome! Please read our Contributing Guide before submitting a PR.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow the existing code style
- Write TypeScript with proper types
- Test on both iOS and Android
- Update documentation as needed
This project is licensed under the MIT License - see the LICENSE file for details.
- Inspired by classic party games like Spyfall and The Chameleon
- Built with the amazing Expo platform
- Icons from Ionicons
Made with love for parties and social gatherings