Skip to content

ArnavK-09/minimal-text-games

Repository files navigation

๐ŸŒ€ 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
Decode owo-fied text! [Multi Player]
Demo
Chat RPG! [Single Player]
Demo
Multiplayer Game Results
Demo

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 folder

  • ๐Ÿ™…โ€โ™€๏ธ Guess the Image Prompt!

Player1 (Host)
guess_the_prompt_desktop
Player2 (Guest)
guess_the_prompt_mobile
  • ๐Ÿฆ‰ Decode Owoify Text!

Player1 (Host)
owoify_text_desktop
Player2 (Guest)
owoify_text_mobile

๐Ÿคผโ€โ™‚๏ธ Addons

Here's a sneak peek at some addons to site

Context Menu
Addon
Flagsmith Notifications
Addon

๐Ÿ› ๏ธ 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:

    cd minimal-text-games
    npm install
  • Install SHADCN components:

    npm run ui
  • Set up environment variables { Example:- .env.example file } for MongoDB, Prisma, and other services.

  • Start the development server:

    npm run dev
  • Open your browser and navigate to 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

๐ŸŒŸ 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.