Welcome to IVYSTUDY, a dynamic, interactive, and fully free study platform built to provide open access to high-quality IB-aligned lessons and resources.
This documentation outlines how the system works and how data is structured and accessed.

IVYSTUDY uses GitHub as a data backend. All lesson content and structure metadata is stored as raw files in a GitHub repository.

Rather than using GitHub's API (which has rate limits and complexity), the platform uses basic fetch calls to retrieve data directly from raw.githubusercontent.com.

flowchart TD
    A[IVYStudy.org Frontend] -->|Fetch via raw.githubusercontent.com| B[Main JSON Index File]
    B --> C[Parse JSON: lesson tags, structure, metadata]
    C --> D[Determine which lesson files to load]
    D -->|Fetch each file| E[Access Raw Lesson Content on GitHub]
    E --> F[Render content dynamically on the site]
    A -.-> G[Note: GitHub raw protocol used instead of GitHub API]

• Simplicity: No need for a backend server or API authentication.
• Transparency: All data is publicly viewable and version-controlled on GitHub.
• Scalability: JSON and lesson files can be added or updated without changing frontend code.
• Limitations: Raw GitHub fetches are primitive (no directory listings, metadata, etc.), so a master JSON file is used to describe the site structure.

IVYSTUDY is a free, open-access study platform built to support IB students by organizing lessons, topics, and resources in a structured and searchable way. It is entirely anonymous and open-source.

To begin using the platform:

1. Go to ivystudy.org.
2. Use the search bar to find lessons by keyword, topic, or tag.
3. Click on a result to view the full lesson content.

The platform loads content dynamically from GitHub, ensuring that every lesson is always up to date and version-controlled. No login is required, and everything is freely accessible.

IVYSTUDY was designed with both transparency and privacy in mind.

1. No accounts are required to use the platform. No personal data is collected.
2. No cookies or IP trackers are used. We do not use analytics services that store IPs or user behavior.
3. We do track total views however this is done anonymously and in such a way that no personally identifying information is collected
4. All content is loaded from public GitHub repositories using raw fetch requests. This ensures that the data is inspectable and version-controlled by design.

We believe that study platforms should be secure by default and private by principle. If you have concerns or suggestions, please open an issue on the GitHub repository.

License: Unless otherwise stated, all materials on IVYSTUDY are published under the Creative Commons Attribution 4.0 International (CC BY 4.0) and the MIT Liscense (As is explained on the main repo page). You are free to share and adapt the materials as long as you give appropriate credit.

Disclaimer:

IVYSTUDY is an independent, student-created educational resource. It is not affiliated with the International Baccalaureate (IB) or any official IB organization.

While we strive for accuracy, IVYSTUDY does not guarantee that all content fully aligns with current IB standards. Always cross-reference with official IB materials or your teachers when preparing for assessments.