Documentation
Find everything you need to know to get the most out of Qubio.
Getting Started
Welcome! Getting started is simple. The first step is to create an account and join a group.
1. Sign Up
If you don't have an account, click the 'Register' button on the homepage. You can sign up using your Google account or with an email and password.
2. Join a Group
After signing up, you'll be prompted to join a group. You'll need a 6-character Group Code from your group's administrator. Enter this code to send a request to join.

Once an admin approves your request, you'll have full access to the group's dashboard!
The Dashboard: Your Hub
The dashboard is your central hub for what's happening. It's designed to give you a quick overview of upcoming events, your personal stats, and any pending debts.
Next Session Card
The 'Next Session' card is your go-to for upcoming events. Here you can RSVP by clicking 'I'm Attending!'. If your plans change, you can cancel your attendance from the same card.


Session Details & Comments
Clicking any session card will open a detailed view with a countdown, a full list of attendees, food, games played, and a new comments section. Any attendee can add, edit, or delete their own comment, making it a great place for post-game discussion or planning for the next one!

My Debts Card (Pro Feature)
This card helps you keep track of any money you owe or that is owed to you from past sessions. You can easily mark when you've paid someone, or when someone has paid you back, keeping everything clear and settled.


Personal Stats (Pro Feature)
At the bottom of the dashboard, you'll find a detailed breakdown of your performance and participation. This includes your total points, win/loss ratio, attendance rate, and more. You can also use the dropdown menu to view the same detailed stats for any other player in your group.

Leaderboards & The Point System
Friendly competition is at the heart of the fun! The Leaderboard page shows who is on top, and it's all based on a customizable point system.
How Points Are Earned
Admins can configure how many points are awarded for different activities. Here's a typical breakdown:
- Winning Games: The primary way to earn points. Each game is worth a different amount, set by the admin.
- Attending Sessions: Just for showing up! Encourages participation.
- Hosting: A big thank you to the host who opens up their space.
- Cooking: For those who feed the group, extra points are on the menu.
- Custom Contribution: Admins can create a custom category (e.g., 'Cleanup Crew', 'Brought a New Game') and award points for it.
- Admin Adjustments: Admins can manually add or subtract points for special contributions or penalties.

Understanding the Leaderboards
The Leaderboard page shows where everyone stands. The 'Overall' tab combines all points for a general ranking. For Pro groups, you can also view specialized leaderboards for attendance, specific games, cooking, and more to recognize everyone's contributions!
Championships & Prize Pools
Admins can enable a 'Championship Season' with a start and end date. When active, a prize pool is calculated based on attendance. For every session a person attends during the season, a set amount (e.g., €1) is added to the pool. At the end of the season, a winner is crowned!
Tracking Expenses (Pro Feature)
Splitting costs for pizza, drinks, or new games is easy. The Expenses page, available on Pro plans, handles all the math for you.
1. Add Your Expenses
Find the relevant session on the Expenses page and click 'Add Expense'. Enter the amount you spent and a brief description. All attendees must do this.

2. Split Expenses Fairly
By default, expenses are split among all attendees. However, you can toggle off 'Divide among everyone' to select specific participants for an expense, including guests. This is perfect for situations where only a few people shared a particular item.

3. Finalize & Calculate
Once everyone has added their expenses, an admin can 'Finalize' the session. The app will automatically calculate who owes what to whom, generating a list of debts.
4. Settle Up
You can see all your outstanding debts on the Expenses page and on your Dashboard. Once you've paid someone, you can mark the debt as settled. The person you paid can also mark it as settled on your behalf.

Team Generator
Need to make fair teams quickly? The Team Generator does it for you. You can find it in the main sidebar.
Simply select the players who will participate, the number of players you want on each team, and click 'Generate'. The app will instantly create random, balanced teams. If there are any leftover players, they will be listed separately.

Admin Features
Admins have special permissions to manage the group and keep things running smoothly. The admin sections are accessible from the sidebar.
Key Admin Tasks:
- Manage Sessions: Create new sessions, edit existing ones (even after they are completed), and manage attendees, games, and food. You are the source of truth.
- Manage Users: Approve pending requests from new members and assign or remove admin roles. You can also edit user display names.
- Manage Games & Food: Add or edit the list of available games and food items for your group.
- Adjust Points: Manually add or subtract points from users for special circumstances.
- Settings: Configure the point system (including the custom contribution), enable championship seasons, and set the prize pool rules.

