Imposter

A small multiplayer party app built with React + Vite — simple local/single-machine play UI for running an Imposter-style game.

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

Imposter is a lightweight, client-side game UI for running an Imposter-style experience. It uses a playlist/word list and simple screens to coordinate rounds and reveal roles. The app is built with modern frontend tooling for fast local development and easy deployment.

Demo preview:

Live demo: https://imposter.ch3n.cc
Repository: https://github.com/rednotsus/imposter

(back to top)

Built With

• 
• 
• 
• 
• 

(back to top)

Getting Started

To get a local copy up and running, follow these steps.

Prerequisites

• Node.js 18+ recommended
• npm (or yarn/pnpm)

Installation

1. Clone the repo

   git clone https://github.com/rednotsus/imposter.git
   cd imposter

2. Install dependencies

   npm install

3. Run the dev server

   npm run dev

4. Open the app at the address printed by Vite (usually http://localhost:5173)

Build for production:

npm run build
npm run preview

(back to top)

Usage

• Start the app and create a game session.
• Add players and start rounds from the UI.
• The UI includes screens to reveal roles, pick categories or words, and show the imposter reveal.

For per-route or per-room meta handling, consider adding dynamic head/meta tags if you deploy to a platform that needs per-page SEO.

(back to top)

Roadmap

• Add online multiplayer sync (WebSocket)
• Skipping/voting controls
• Improved UI/UX and animations
• Admin panel for playlist/word management

See the open issues for a full list of proposed features and known issues.

(back to top)

Contributing

Contributions are welcome! To propose changes:

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

If you have suggestions, open an issue with the "enhancement" label.

(back to top)

Top contributors:

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

• Project: https://github.com/rednotsus/imposter
• Live demo: https://imposter.ch3n.cc

(back to top)

Acknowledgments

• Radix UI
• Tailwind Labs
• Vite
• The open source community and contributors

---