Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/VasquezRivero92/HabboCafe/llms.txt

Use this file to discover all available pages before exploring further.

HADOS is a full-stack web application built for the HabboCafe community to run, manage, and track Habbo Hotel dice tournaments. It combines Firebase real-time data, a four-tier role system, and Habbo avatar integration into a single cohesive platform that tournament organizers and players can use directly from their browser.

Quickstart

Clone the repo, configure Firebase, and have your tournament platform running in under 10 minutes.

Architecture

Understand the tech stack, Firebase collections, and how the real-time data flow works.

Core Concepts

Learn about Dados, roles, and the tournament lifecycle that powers HADOS.

Administration

Configure your Global Admin account, create Dados, and manage the full platform.

What is HADOS?

HADOS organizes Habbo Hotel dice competitions across multiple independent groups called Dados. Each Dado is its own isolated tournament with its own leaderboard, players, rules, and schedule. A hierarchy of roles controls who can create tournaments, load points, or simply view standings.

Real-Time Leaderboards

Live rankings update instantly via Firestore onSnapshot listeners — no page refresh needed.

Role-Based Access

Four roles — Global Admin, Dado Admin, Intermediario, and Jugador — each with precisely scoped permissions.

Habbo Avatars

Player avatars are fetched live from habbo.es imaging API using each player’s Habbo nickname.

Multi-Dado Support

Run unlimited simultaneous tournaments. Players and admins switch between Dados from the navbar.

Tournament Lifecycle

Start a tournament with a date range, accumulate points, then reset scores for the next event.

Point Management

Intermediarios load points via quick-add buttons or a modal with live rank preview.

Getting Started

1

Set up Firebase

Create a Firebase project, enable Firestore and Email/Password Auth, and copy your config values. See Firebase Setup for the full walkthrough.
2

Configure the app

Paste your Firebase credentials into src/firebase.ts and set your environment for local development or production. See Environment Configuration.
3

Run the dev server

Install dependencies and start Vite to see the login screen locally.
npm install
npm run dev
4

Create your Global Admin account

Register with the Global Admin secret code to unlock full platform management. See Global Admin Guide.
HADOS is designed to be self-hosted. All data lives in your own Firebase project — HabboCafe does not operate any shared backend.

Build docs developers (and LLMs) love