PlotTwist is a full-stack language learning web application that helps users practice real-world conversations by interacting with an AI assistant in scenario-based roleplay.

Users choose a target language, proficiency level, and situation (e.g., ordering food, buying groceries, asking for directions), and the app generates adaptive, contextual dialogue to simulate realistic conversations.

• Practice conversations in multiple languages
• Scenario-based roleplay (restaurants, shopping, travel, etc.)
• AI-generated responses tailored to user input and proficiency level
• Interactive chat interface
• Built with modern React and Vite

• Frontend: React 19, React Router
• Build Tooling: Vite
• AI Integration: OpenRouter API

• Node.js 18+
• npm

git clone https://github.com/nb488/LanguageScenarioPractice.git

Edit the .env file in the project root:

VITE_OPENROUTER_API_KEY=your_api_key_here

npm install

npm run dev

The app will be available at http://localhost:5173

• Speech-to-text and text-to-speech support
• User accounts and saved progress
• Improved conversation feedback and corrections

This project was developed during the BU1DL 4-month program, with support and feedback from mentors throughout its development..

This project is intended for educational and portfolio purposes. API usage may incur costs depending on the OpenRouter model selected.