Adventure Closure

A decision making game, make a fortune and conquer the universe! 💰🚀

The problem

Create an idle business sim-game. The basic idea is to purchase a business, win capital from that business, upgrade the business and then purchase more businesses. The way to win capital in Adventure Closure is once you’ve purchased a business, you need to click on the business and it takes some time to gain the capital. Once done, you can click again. In order to automate this, you can hire a manager who can run the business for you, so you don’t have to click manually anymore. Then you can upgrade the business and gain even more money. The game is idle, so it progresses while you are away: If you have a manager, the game should continue playing while you’re gone.

• Buy and upgrade businesses. There should be several business types to choose from.
• Make money from a business. (i.e. you click on a business and in a certain amount of time you get money).
• Hire managers, so that money is made automatically.
• When you close the game, next time you open it, you should see the money that your businesses made for you. (Businesses continue to make progress while you’re away).

The solution

This is a Work in progress, loading...

Do you want to see this awesome game in action?

• APP: https://adventure-closure.firebaseapp.com yay! 🎉
• API (Exist 2 options and both support WebSockets for real-time communication) 👯
  • Heroku with session affinity: https://adventure-closure.herokuapp.com/api
  • Google Cloud App Engine with Flexible environment (Stopped to avoid costs): http://proyecto-26-244415.ue.r.appspot.com/api

There're some tasks as work in progress (Check TODO) because this example is using real-time communication with WebSockets in order to have all business logic from Backend, in this way we can provide better security for our apps, scaling on demand and managing money the right way, never trusting in your users 😅

Installation 📚

Running the app

cd app

# install dependencies
$ yarn

# development (https://localhost:8080)
$ yarn start

# deploy to production (Firebase Hosting)
$ yarn deploy

Running the api

• Install PostgreSQL with default configuration (using PORT 5432).

cd api

# create a new database called "my_database"
$ yarn global add pgtools
$ npx createdbjs my_database --user=postgres --password=postgres

# install dependencies
$ yarn

# development (http://localhost:3000/api)
$ yarn start:debug

# deploy to production (Google Cloud Hosting API)
$ yarn deploy

Test 🕵️

# unit tests
$ yarn test

TODO 📝

• Use a game engine like Phaser Framework to create better user experiences with WebGL/Canvas.
• Define a Component-based architecture for separation of concerns.
• Use a Mobile first framework like Ionic to build a cross-platform app (Mobile, Desktop and Web).
• Use Web Components and Web animations to improve the UI/UX and build a high performance web app using web-standards.
• Use TypeScript to improve the quality of the code and reduce maintenance costs and technical debt of the project.
• Use patterns like Repository design and dependency injection to have a modular architecture.
• Use SOLID following Software principles like SRP, DRY, KISS, etc to create a system that is easy to maintain and extend over time.
• Use platform-agnostic tools to scale the system easily.
• Add authentication/authorization for security concerns (JWT, Basic Authorization, Role-based access control, etc).
• Add testing utilities like Enzyme to write better tests for the components and help to reduce the complexity of the code.
• Use OpenAPI specification with Swagger to describe the endpoints of the RESTful API.
• Use a logger like Winston to track exceptions easily.
• Enable CORS to allow access to a list of domains for restricted resources.
• Add default data (Businesses, Managers, etc) with database migrations.
• Use Websockets to have a real-time communication with a Event-driven architecture.
• Add login/register screens or use Facebook Instant games instead to authenticate users.
• Load the info of the current user
• Enable buttons purchasing a new business and improve the user experience/gamification.
• Enable hiring managers to run business automatically.
• Use Atlasses instead of images or sprites-sheets to reduce memory and bandwidth loading textures.
• Use RxJS for Observer pattern handling requests, events, etc.
• Manage game scaling and use media queries to support multiple resolutions and devices.
• Use Facebook Instant Games SDK to integrate services like In-App Purchase and distribute the game in multiple platforms.
• Use a multi-package repository for shared logic between front-end and back-end (Lerna, etc).
• Use Cloud Storage to store assets like images, audios, etc to be accessed via HTTPs with security mechanisms to control access to data (Google Cloud Storage, AWS S3, Azure Blob Storage, etc).
• Use Secrets Manager to retrieve database credentials, API keys, etc to avoid hardcoded credentials.
• Use in-memory data store like Redis to avoid many accesses to the database by using cache.
• Use Microservices strategy for complex calculations and horizontal scaling, To infinity and beyond!
• Create a Docker image with the configuration to run the project anywhere.
• Support PWA and Offline mode (SQLite, Cache with Service Workers, etc) to improve the UX with other kind of games (Nice to have for fun).
• Share the end results and inspire others with Open Source contributions.

Credits 👍

Some resources used here are part of my Open Source contributions:

• IonPhaser: A web component to integrate Phaser Framework with Angular, React, Vue, etc 🎮.
• MyApi Template: A template to create awesome APIs easily ⚡️.
• Animatable: A Web Component to use WAAPI in a declarative way.
• Awesome JavaScript Games: A curated list of awesome JavaScript Games 🎮.

Other resources:

• Elon Musk image: By Algarifma.

Supporting 🍻

I believe in Unicorns 🦄 Support me, if you do too.

Donate Ethereum, ADA, BNB, SHIBA, USDT, DOGE:

Wallet address: 0x3F9fA8021B43ACe578C2352861Cf335449F33427

Please let us know your contributions! 🙏

Happy coding 💯

Made with <3