зеркало из
https://github.com/kodackx/disinformation-quest.git
synced 2025-10-29 20:46:05 +02:00
e81392e3be
Revised the README to reflect the current project structure and objectives. Added information about the project's availability in both Romanian and English. Included the live URL for testing: https://2-plus-2.com/. [skip gpt_engineer]
73 строки
2.4 KiB
Markdown
73 строки
2.4 KiB
Markdown
# Disinformation Quest
|
|
|
|
An interactive narrative experience exploring the mechanics of disinformation through a thought-provoking simulation. Available in both English and Romanian at [2-plus-2.com](https://2-plus-2.com/).
|
|
|
|
## Project Overview
|
|
|
|
This project serves as both an educational tool and a thought experiment on how mathematical truths can be challenged through various psychological and social mechanisms. Through an immersive game-like experience, users take on the role of a disinformation agent tasked with spreading the notion that "2+2=5".
|
|
|
|
### Key Features
|
|
|
|
- **Interactive Narrative**: Progress through multiple stages of a disinformation campaign, making strategic choices that affect the outcome
|
|
- **Multilingual Support**: Full support for English and Romanian languages with automatic detection based on user's location
|
|
- **Immersive Audio**: Voice-acted briefings and atmospheric sound design
|
|
- **Dynamic Visualizations**: Real-time animations illustrating the impact of your choices
|
|
- **Progress Tracking**: Visual metrics showing the effectiveness of your campaign
|
|
|
|
## Technical Implementation
|
|
|
|
### Tech Stack
|
|
- **Frontend Framework**: React with TypeScript
|
|
- **Build Tool**: Vite
|
|
- **UI Components**: shadcn/ui
|
|
- **Styling**: Tailwind CSS
|
|
- **State Management**: TanStack Query
|
|
- **Internationalization**: i18next
|
|
- **Routing**: React Router
|
|
- **Animation**: Framer Motion
|
|
|
|
### Project Structure
|
|
```
|
|
src/
|
|
├── components/ # Reusable UI components
|
|
│ ├── game/ # Game-specific components
|
|
│ └── ui/ # shadcn/ui components
|
|
├── pages/ # Main application pages
|
|
├── hooks/ # Custom React hooks
|
|
├── i18n/ # Internationalization config and translations
|
|
├── utils/ # Utility functions
|
|
└── styles/ # Global styles and Tailwind config
|
|
```
|
|
|
|
## Getting Started
|
|
|
|
### Prerequisites
|
|
- Node.js (LTS version recommended)
|
|
- npm or yarn package manager
|
|
|
|
### Local Development
|
|
```bash
|
|
# Install dependencies
|
|
npm install
|
|
|
|
# Start development server
|
|
npm run dev
|
|
|
|
# Build for production
|
|
npm run build
|
|
|
|
# Preview production build
|
|
npm run preview
|
|
```
|
|
|
|
## Contributing
|
|
|
|
We welcome contributions! Please feel free to submit a Pull Request.
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License - see the LICENSE file for details.
|
|
|
|
## Live Demo
|
|
|
|
Experience the simulation at [2-plus-2.com](https://2-plus-2.com/) |