> For the complete documentation index, see [llms.txt](https://cshackathon.gitbook.io/studybratz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cshackathon.gitbook.io/studybratz/readme.md).

# Developer Platform

Welcome to your team’s developer platform

<h2 align="center">Bratz Study</h2>

**Turn studying into a fun, Y2K-inspired game!**\
Pick a Bratz-style avatar, complete study sessions, earn XP, level up, unlock study powers, and decorate your virtual room. Gamify learning while actually improving your knowledge in *any subject you want*.

> **Track:** Make Learning Fun\
> **Hackathon:** CS Girlies Global Hackathon, November 2025

### 🎯 **Why StudyBratz?**

Many students struggle to stay motivated using traditional study tools. Notes feel boring, repetition becomes exhausting, and learning often turns into a chore.

However, **recent studies show that people remember information better when it’s tied to strong emotions** — such as joy, excitement, or nostalgia. Childhood nostalgia, in particular, boosts memory formation and increases focus.

✨ **StudyBratz uses this psychological effect intentionally.**\
By blending learning with fun Y2K aesthetics, childhood-style avatars, and rewarding progression systems, the platform helps users retain more while feeling genuinely motivated to keep studying.

**In other words:**\
We make studying emotionally memorable — so it actually sticks.

### **✨ Core Features**

* AI-generated flashcards from user topic or uploaded notes
* Study sessions → earn XP
* Level up and unlock study powers: Pomodoro, Feynman, Active Recall, Spaced Repetition
* Supports **any subject**: Biology, Tech, History, Math, Languages, etc.

### **🕹 How It Works**

1. **Select Topic or Upload Notes** – Choose the subject you want to study
2. **AI Flashcards Generated** – Instant Q/A flashcards for your deck
3. **Study & Earn XP** – Complete sessions, track progress
4. **Level Up & Unlock** – Gain new study powers and cosmetics for your avatar

```
// Topic/Notes → AI Flashcards → Study → XP → Level Up → Unlock Powers/Cosmetics
```

### **📺 Demo Video**

Watch the app in action!\
[\[our demo video here\]](https://www.youtube.com/watch?v=8wVd37fJqu4)

### **🖼 Screenshots of the demo**

<div><figure><img src="https://115022896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2rCYMjic8vhlgTZrJVlh%2Fuploads%2FHDq9ncttFsTNrbeRq2VH%2Fcharselectdemo.png?alt=media&amp;token=bb4dc761-2f9f-4d42-beef-33741376963b" alt=""><figcaption></figcaption></figure> <figure><img src="https://115022896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2rCYMjic8vhlgTZrJVlh%2Fuploads%2FAbpbnhPHwpq8z87vR0fn%2Ffileuploaddemo.png?alt=media&amp;token=b2ec2f47-6afe-4463-8460-5f6b80dacea2" alt=""><figcaption></figcaption></figure> <figure><img src="https://115022896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2rCYMjic8vhlgTZrJVlh%2Fuploads%2FfK1AfZrwksExmwE4Yo84%2Fmcqdemo.png?alt=media&amp;token=6dd25f76-b6dd-4f04-9378-d05c2a054f53" alt=""><figcaption></figcaption></figure> <figure><img src="https://115022896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2rCYMjic8vhlgTZrJVlh%2Fuploads%2Fq7ju2DUvLADp8XroUYW2%2Fmindmapdemo.png?alt=media&amp;token=0bf4c17d-5931-4532-9c9f-4a24470ee372" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cshackathon.gitbook.io/studybratz/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
