Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/arnavk-09/minimal-text-games

🌀 AI-powered multiplayer text guessing games....
https://github.com/arnavk-09/minimal-text-games

dalle flagsmith mongodb mongodb-orm openai prisma shadcn socket-io sveltekit websockets

Last synced: 21 days ago
JSON representation

🌀 AI-powered multiplayer text guessing games....

Awesome Lists containing this project

README

        

# 🌀 Minimal Text Games 🌀

Welcome to the exciting world of Minimal Text Games! Get ready for an immersive gaming experience powered by cutting-edge AI technology. 🚀

Cover"

> [!NOTE]
> Introducing our AI-powered player games, created with love! Our backend relies on Mongo DB and Sockets to provide a full real-time gaming experience. With a wide variety of captivating games to choose from, there's something for everyone. Dive into the world of multiple games and let the excitement begin!

---

## 📚 Description

> Introducing our AI-powered text-based games, created with love! 💖 Our backend relies on MongoDB and Sockets to provide a full real-time gaming experience. With a wide variety of captivating games to choose from, there's something for everyone. Dive into the world of multiplayer or single-player games and let the excitement begin!

# 🎮 Demos

### 🖼️ Screenshots

> Here's a sneak peek at some of the games in action:

| Guess the Prompt! [Multi Player] |
|------------|
| ![Demo](static/guess_the_prompt.jpeg) |

| Decode owo-fied text! [Multi Player] |
|------------|
| ![Demo](static/owoify_text.jpeg) |

| Chat RPG! [Single Player] |
|------------|
| ![Demo](static/chat_rpg.jpeg) |

| Multiplayer Game Results |
|------------|
| ![Demo](static/results.jpeg) |

And more games are on the way! 🎉

### 📹 Video Demos

> Want to see the games in action? Check out this video demo:

> [!TIP]
> Embeds below are low quality gifs, used just for the readme. For high quality clear demo videos checkout [**` static `**](static) folder

- #### 🙅‍♀️ Guess the Image Prompt!

| [Player1 (Host)](static/guess_the_prompt_desktop.webm) |
|------------|
| ![guess_the_prompt_desktop](https://github.com/ArnavK-09/minimal-text-games/assets/69188140/127128d9-2fd7-4978-9bde-b85c8b4623e9) |

| [Player2 (Guest)](static/guess_the_prompt_mobile.webm) |
|------------|
| ![guess_the_prompt_mobile](https://github.com/ArnavK-09/minimal-text-games/assets/69188140/dfe78712-0204-4f5d-bd0b-811e27a0b928) |

- #### 🦉 Decode Owoify Text!

| [Player1 (Host)](static/owoify_text_desktop.webm) |
|------------|
| ![owoify_text_desktop](https://github.com/ArnavK-09/minimal-text-games/assets/69188140/f3872bbd-8690-4116-ac20-10ac4fc87dda) |

| [Player2 (Guest)](static/owoify_text_mobile.webm) |
|------------|
| ![owoify_text_mobile](https://github.com/ArnavK-09/minimal-text-games/assets/69188140/cdcbea40-1d07-484f-a80b-140f0ede5ecb) |

### 🤼‍♂️ Addons

> Here's a sneak peek at some addons to site

| Context Menu |
|------------|
| ![Addon](static/context.jpeg) |

| Flagsmith Notifications |
|------------|
| ![Addon](static/flagsmith.jpg) |

---

## 🛠️ Tech Stack

> Minimal Text Games is built using the following technologies:

> [!TIP]
> - **Frontend**: SvelteKit, Tailwind CSS, Shadcn ui
> - **Backend**: MongoDB, Prisma, Flagsmith
> - **AI Integration**: OpenAI, DALL-E

## 🚀 Getting Started

> Follow these steps to run Minimal Text Games locally:

- Clone the repository:
```
git clone https://github.com/ArnavK-09/minimal-text-games.git
```

- Install dependencies:
```bash
cd minimal-text-games
npm install
```
- Install SHADCN components:
```bash
npm run ui
```

- Set up environment variables **{ Example:- [` .env.example `](.env.example) file }** for MongoDB, Prisma, and other services.

- Start the development server:
```bash
npm run dev
```

- Open your browser and navigate to [**` http://localhost:5173 `**](http://localhost:5173) to see the app in action.

---

## 🧏‍♀️ Contributing

We welcome contributions to make Minimal Text Games even better! Here's how you can get involved:

> [!IMPORTANT]
>
> 1. Fork the repository.
> 2. Create a new branch for your feature or bug fix.
> 3. Make your changes and commit them with descriptive messages.
> 4. Push your changes to your forked repository.
> 5. Submit a pull request to the main repository, describing your changes in detail.

## 🏁 Flagsmith Config

| Flagsmith Admin Panel |
|------------|
| ![Flagsmith](static/flagsmith.jpeg) |

---

## 🌟 Show Your Support

> [!TIP]
> If you like Minimal Text Games, please consider giving it a ⭐️ on GitHub! Your support means a lot to us. 🙏

Thanks for checking out Minimal Text Games! Happy gaming! 👋

---
---

> [!CAUTION]
> For optimal performance and stability, please be aware that the **Socket.io plugin with Svelte Kit may exhibit some instability**, potentially hindering its production functionality. To ensure a smooth user experience, we kindly request testing the application on the development server utilizing the command **` npm run dev `**. **Thank you** for your cooperation in ensuring the reliability of our application.