# Shine

> Shine designs and simulates photonic circuits: free-space optics, waveguide components, and the electronics that drive and read them. Light is solved exactly (interference, resonances, several wavelengths); electronics are simple logic, registers and function cells. It runs in the browser, as a desktop app, as a Rust library, and as an MCP server.

Everything below in one file: https://shine.lupyd.com/llms-full.txt

## Docs

- [Shine documentation](https://shine.lupyd.com/docs/): What Shine is, where to start, and a map of every guide.
- [Getting started](https://shine.lupyd.com/docs/getting-started/): Open Shine in the browser or install the desktop app, tour the window, and simulate your first circuit.
- [Editing](https://shine.lupyd.com/docs/editor/): Placing parts, selecting and moving, the add menu, the parts browser, and every keyboard and mouse shortcut.
- [Parts reference](https://shine.lupyd.com/docs/parts/): Every part and block in the library, with its ports, parameters and behaviour.
- [Wiring light and signals](https://shine.lupyd.com/docs/wiring/): Beams, waveguides and signal wires; why light and signals never connect directly, and the converters that join them.
- [Components](https://shine.lupyd.com/docs/components/): Turn a layout into a reusable box with light ports and signal pins, open it with Tab, and try it on its own.
- [Electronics and the clock](https://shine.lupyd.com/docs/electronics/): Number inputs, displays, registers, the clock, threshold detectors and function cells, with the full expression reference.
- [Examples](https://shine.lupyd.com/docs/examples/): The ready-made circuits, what each shows, and how realistic it is.
- [How the simulation works](https://shine.lupyd.com/docs/simulation/): What Shine solves exactly, what it models simply, and the limits to keep in mind when reading results.
- [Projects and files](https://shine.lupyd.com/docs/files/): Saving and opening projects, the .shine binary format, desktop and browser builds, and logging.
- [AI assistants (MCP)](https://shine.lupyd.com/docs/ai/): Use Shine from Claude and other Model Context Protocol clients, and how language models should approach Shine.
- [Rust library](https://shine.lupyd.com/docs/library/): Use Shine's photonics crate without the editor to build, compile and run optical circuits from Rust.
- [Development](https://shine.lupyd.com/docs/development/): Building from source, running tests, keeping the documentation and screenshots current, and how releases are made.
- [Roadmap](https://shine.lupyd.com/docs/roadmap/): Where Shine is going, what's being built for 0.2, and what comes after.
- [Changelog](https://shine.lupyd.com/docs/changelog/): What changed in each version of Shine.

## Optional

- [Web app](https://shine.lupyd.com/app/): the editor; ?example=<name> opens an example
- [Source code](https://github.com/ash-hashtag/shine)