> ## Documentation Index
> Fetch the complete documentation index at: https://learn.playlab.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Illustrative Mathematics Guide

> Build Playlab apps with Illustrative Mathematics curriculum

## What is this feature?

Playlab has partnered with the Chan Zuckerberg Initiative to bring Illustrative Mathematics curriculum into the global references library, allowing you to build custom AI apps that leverage the entire Illustrative Mathematics curriculum without having to manually upload lesson plans, course guides, and other materials.

## Rationale for the feature

Most curricula, including Illustrative Mathematics, are designed for paper, not for AI models. For example, variables and equations are stored as images, and concept maps have no clear link to unit plans or lessons when read by an AI model. Simply uploading curriculum into an AI model doesn't work effectively without modifying and restructuring the underlying data.

Working closely with the team at CZI, we've restructured Illustrative Mathematics content into a format that works well with AI, making significant improvements to our core Retrieval Augmented Generation (RAG) technology.

## Watch How to Build with IM in Playlab

Watch a video demonstration of how to sign into Playlab for the first time.

## Watch How to Leverage References

<iframe src="https://www.loom.com/embed/11c41294efd34c24a6f1c51579b3a909?sid=932de8a9-cfc2-4d7f-9031-da4c36d1cf32" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style={{ width: "100%", maxWidth: "720px", aspectRatio: "16 / 9", margin: "1.5rem auto", display: "block" }} />

<figcaption>Building with Illustrative Mathematics</figcaption>

## Where can I access the feature?

<Frame>
  <img src="https://mintcdn.com/playlabai/3KUkXnizECw3JUVl/images/imreferences.gif?s=7d062e65173321e3cda0127d81e093a8" width="1420" height="1000" data-path="images/imreferences.gif" />
</Frame>

<Steps>
  <Step title="Log into your Playlab account and open your Playlab Builder" />

  <Step title="Click the References icon on the right sidebar">
    <Frame>
      <img src="https://mintcdn.com/playlabai/2GudnHxecWf15e3-/images/reference%20icon.png?fit=max&auto=format&n=2GudnHxecWf15e3-&q=85&s=36f6a3ab30701730d569901742a769aa" width="114" height="92" data-path="images/reference icon.png" />
    </Frame>
  </Step>

  <Step title="Click and select 'Browse libraries'">
    <Frame>
      <img src="https://mintcdn.com/playlabai/3KUkXnizECw3JUVl/images/browselibraries.png?fit=max&auto=format&n=3KUkXnizECw3JUVl&q=85&s=20b1a6c77f7aac30de4dc73c0ffbe221" width="1020" height="578" data-path="images/browselibraries.png" />
    </Frame>
  </Step>

  <Step title="Under 'Curricula & standards' select Illustrative Mathematics">
    <Frame>
      <img src="https://mintcdn.com/playlabai/3KUkXnizECw3JUVl/images/im%20global.png?fit=max&auto=format&n=3KUkXnizECw3JUVl&q=85&s=9973e5dc9e1b99794c1ce37f7a6670e6" width="1968" height="1164" data-path="images/im global.png" />
    </Frame>
  </Step>
</Steps>

## How to use Illustrative Mathematics

<Steps>
  <Step title="Browse the Illustrative Mathematics reference library">
    Access all IM resources organized by grade, unit, and additional resources.
  </Step>

  <Step title="Select specific references">
    Choose which specific materials you want to add to your app as you browse through the library.
  </Step>

  <Step title="Add references to your app">
    Click "Add to App" to attach the selected references to your specific Playlab app.
  </Step>

  <Step title="Build your app with IM curriculum integration">
    Your app can now leverage the structured Illustrative Mathematics content.
  </Step>
</Steps>

## Benefits of the IM Integration

<li><strong>Improved Accuracy:</strong> Organized data helps AI retrieve precise and relevant information for students and educators.</li>
<li><strong>Enhanced Accessibility:</strong> Clear structure allows for faster, more direct responses, reducing confusion.</li>
<li><strong>Support for Diverse Learners:</strong> Structured content helps the model adapt to different learning needs with tailored explanations and examples.</li>
<li><strong>Facilitated Connections:</strong> Organized data enables AI to link concepts, making learning more integrated and meaningful. This is reflected in references around pacing, dependencies, and scoping.</li>
<li><strong>Reduced Errors:</strong> Clear data prevents misunderstandings and ensures trustworthy responses in educational contexts.</li>
<li><strong>Easy Updates:</strong> Well-structured data is easier to update and expand, ensuring materials stay aligned with evolving standards.</li>

## FAQ

<Accordion title="What resources are available in the Illustrative Mathematics reference library?">
  In addition to the instructional materials for each unit, the course outlines, pacing guides, design principles, and unit dependencies are available for your app to reference. If you would like other resources from Illustrative Mathematics to be enabled on Playlab, please let us know at [support@playlab.ai](mailto:support@playlab.ai).
</Accordion>

<Accordion title="Can I edit the Illustrative Mathematics references?">
  You cannot download or edit the Illustrative Mathematics references. This is to ensure that the references maintain their standard. For customized versions, we recommend creating separate references specific to your needs.
</Accordion>

<Accordion title="Can I add references from multiple grades?">
  Yes, you can add Illustrative Mathematics references from multiple grades to support cross-grade applications.
</Accordion>

<Accordion title="How do I best utilize Illustrative Mathematics in my app?">
  For optimal results, be specific about what you want the app to do with the curriculum. If you want the app to understand the structure of a course or help find specific lessons, include the course outline. If you want assistance with scheduling or pacing, add the relevant pacing guide.
</Accordion>

<Accordion title="Will there be additional curricula added to the global library?">
  Yes, we are currently working on building and adding additional curriculum, standards, and frameworks to the global reference library. If there are specific curricula you're interested in, please email us at [support@playlab.ai](mailto:support@playlab.ai).
</Accordion>

<Accordion title="How does the AI handle mathematical notation and equations?">
  Our partnership with CZI has focused specifically on restructuring mathematical content to work effectively with AI. The integration handles equations, variables, and mathematical notation in ways that standard AI implementations cannot.
</Accordion>

<Accordion title="Can I combine Illustrative Mathematics with my own custom references?">
  Yes, you can combine Illustrative Mathematics references with your own custom references to create apps that blend the curriculum with your specific teaching materials and approach.
</Accordion>

<Accordion title="How do I create an effective math tutor using Illustrative Mathematics?">
  When building a math tutor app, include specific unit references relevant to the topics you want to cover. In your build prompt, specify how you want the AI to scaffold learning, provide hints, and explain concepts in alignment with the Illustrative Mathematics approach.
</Accordion>

## We Want Your Feedback!

<Info>
  As an early user of the Illustrative Mathematics integration, we're asking you to help us validate that this works for you! We're working with Illustrative Mathematics experts across the US to help validate our integration and create robust core apps that you can use or adapt to your context.

  Contact us at [support@playlab.ai](mailto:support@playlab.ai)
</Info>

***

Last updated: 03-21-2025