Skip to content

Repository files navigation

Playora

Playora is a lightweight hobby project built for playing simple web games and reading quick game reviews.

It is kept small and simple. Currently, the site features Asteroids, with room to easily plug in more simple HTML5 games in the future.

Live Demo: playora.aqhr.org


The Tech Stack

Playora is built from scratch without the overhead of heavy frontend frameworks. It is a showcase of what you can do with modern vanilla web technologies:

  • Frontend Structure: HTML5
  • Styling: Vanilla CSS (Modular, component-based styling like ui-glass.css and button-animations.css)
  • Logic: Vanilla ES6+ JavaScript
  • Data: Local JSON files (discover-games.json, community-posts.json)
  • Backend & Auth: Firebase

Local Development & Setup

If you want to run Playora locally, you will need to set up your own Firebase environment. For security reasons, the live Firebase credentials are .gitignored and not included in this repository.

  1. Clone the project:

    git clone https://github.com/YOUR_USERNAME/Playora.git
    cd Playora
    
  2. Set up Firebase:

    • Navigate to the js/ directory.
    • You will see a file named firebase-config.example.js.
    • Create a new, duplicate file in the same folder and name it firebase-config.local.js.
    • Open firebase-config.local.js and paste in your own Firebase project API keys and configuration.
  3. Run the site:

    • Open index.html using your preferred local server (like VS Code Live Server or Node's http-server).

Contributing

Since this is an open-source showcase repository, contributions are welcome. If you have a simple web game you would like to add, a game review to share, or a UI bug to fix, feel free to fork the repository and open a Pull Request.


License

This project uses a dual-license structure:

  • Code: The frontend structure and logic (HTML, CSS, JavaScript) are open-source and available under the MIT License.
  • Assets: All original media assets in the assets/ folder are All Rights Reserved by Playora.
    • Note: This repository contains third-party game covers and platform logos (e.g., PlayStation, Xbox, Steam, etc.) used as functional navigation elements and thumbnails. These are the intellectual property of their respective owners and are not covered by the Playora asset license. Please see ASSETS_LICENSE.txt for full details.

Contact

Created by crummblet. If you have any questions, want to report a bug, or just want to reach out, send an email to: crummblet@outlook.com

About

Playora is a lightweight hobby project built for playing simple web games and reading quick game reviews.

Topics

Resources

Code of conduct

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages