# Flux Student Directory: developer portal

> Public documentation for developers who build apps or experiences alongside Flux Student Directory (a school directory for parents and school staff). No sign-in is needed to read anything listed here; calling the API needs credentials issued by Flux.

## Design system: Sunshine (version 1.0, updated 2026-10-16)

- [Specification, markdown](https://studentdirectory.app/developer/design/sunshine-design-spec.md): the complete specification (color, typography, iconography, spacing, components, accessibility, platform rules) as clean markdown. Read this first.
- [Design tokens, JSON](https://studentdirectory.app/developer/design/tokens.json): the palette (light and dark, text and solid variants), area and grade colors, tints, radii and spacing.
- [Specification, web page](https://studentdirectory.app/developer/design): the same content with sample imagery of every component in light and dark.
- [Specification, PDF](https://studentdirectory.app/developer/design/sunshine-design-system.pdf): for offline use.

## Using it

- Reference colors by palette key or token name, never by hard-coded hex, and support both light and dark appearances.
- Every color is paired with text, an icon or a shape; text colors must meet 4.5:1 contrast (the tokens already provide compliant variants).
- Components are described by purpose, anatomy, sizes, states and accessibility so a new experience can match the product.

## API

- [API reference, web page](https://studentdirectory.app/developer/api): every operation with parameters, request bodies and responses.
- [OpenAPI contract, YAML](https://studentdirectory.app/developer/api/openapi.yaml): the machine-readable contract for the API. Read this first when generating a client.
- [API guide](https://studentdirectory.app/developer/guide): getting credentials, authentication, errors, data handling and versioning.
- [MCP server](https://studentdirectory.app/developer/mcp): connect an AI assistant to the read-only operations of the API.

Every call needs credentials issued by Flux (write to flux-support@fluxstudentdirectory.com); there is no anonymous access.

## Release notes

- [Release notes](https://studentdirectory.app/releases): what is new, improved and fixed in each release, including API changes and deprecations.
- [Atom feed](https://studentdirectory.app/releases/feed.xml), [latest release, JSON](https://studentdirectory.app/releases/latest.json) and [all releases, JSON](https://studentdirectory.app/releases/index.json): machine-readable.