> 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

<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="/files/1LKNRSB2I79LTOj2Bf4x" alt=""><figcaption></figcaption></figure> <figure><img src="/files/BcJOGHgZTBh6Lsf0gq8Q" alt=""><figcaption></figcaption></figure> <figure><img src="/files/8fOnDBj67imkTaAOzLKb" alt=""><figcaption></figcaption></figure> <figure><img src="/files/06CFzr1FmwYGUBWXwufv" 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
