[@previews]: ./previews/preview.components.md
[@examples]: ./example.components.md

# Examples

A small collection of places to read, explore, and learn. Follow your curiosity,
then open the Markdown to see how each one is made.

---

<example-card
  href="/examples/bookcase"
  file="/examples/bookcase/index.demo.md"
  preview="shelf"
  label="01 / A collection"
  details="Book notes · Queries · Components"
  action="Explore the shelf"
>
<slot name="preview">
<span class="example-books" aria-hidden="true">
<book-preview />
</span>
</slot>

## [A personal reading shelf](./bookcase/index.demo.md)

Browse a shelf of books and open the notes inside. Every book begins as a simple Markdown file.

</example-card>

---

<example-card
  href="/examples/chess/opera-game.demo"
  file="/examples/chess/opera-game.demo.md"
  preview="chess"
  label="02 / An interactive lesson"
  details="Annotated moves · Interactive board · Player"
  action="Follow the game"
>
<slot name="preview">
<opera-preview />
</slot>

## [A night at the opera](./chess/opera-game.demo.md)

Follow a brilliant chess game, one move at a time. Discover how a few well-placed pieces work together.

</example-card>

---

<example-card
  href="/examples/color-context.demo"
  file="/examples/color-context.demo.md"
  preview="color"
  label="03 / A guided exercise"
  details="One document · Focus · Slides"
  action="Read the lesson"
>
<slot name="preview">
<color-preview />
</slot>

## [Can you trust this color?](./color-context.demo.md)

Two identical colors can look different. Make a prediction, remove their surroundings, and try the effect yourself.

</example-card>

---

<example-card
  href="/examples/orbit/orbit.demo"
  file="/examples/orbit/orbit.demo.md"
  preview="orbit"
  label="04 / A playable experiment"
  details="Three.js · Gravity simulation · Focus and Slides"
  action="Enter the observatory"
>
<slot name="preview">
<img src="/examples/previews/orbit.svg" alt="A satellite traces a golden orbit around a blue planet." width="640" height="400" loading="lazy" />
</slot>

## [Falling around the world](./orbit/orbit.demo.md)

Launch a satellite, follow the forces, and discover why an orbit is a fall that keeps missing the ground.

</example-card>

---

<example-card
  href="/examples/scroll-story/story.demo"
  file="/examples/scroll-story/story.demo.md"
  preview="reading"
  label="05 / Scroll storytelling"
  details="Markdown Blocks · Literate SVG · Progressive motion"
  action="Read the story"
>
<slot name="preview">
<span class="example-paper" aria-hidden="true">
  <span class="example-paper-label">A story in three parts</span>
  <span class="example-paper-title">One file.<br />A world of possibility.</span>
  <span class="example-paper-rule"></span>
  <span class="example-paper-excerpt">Lesson → example → activity.</span>
  <span class="example-paper-footer">Follow the thread.</span>
</span>
</slot>

## [One file. A world of possibility.](./scroll-story/story.demo.md)

Follow an idea as it becomes a path. Prose enters as you scroll, and a small diagram brings the connections to life.

</example-card>

---

<example-card
  href="/examples/images.demo"
  file="/examples/images.demo.md"
  preview="prints"
  label="06 / A lesson in looking"
  details="Image galleries · Captions · Full-size inspection"
  action="Explore the prints"
>
<slot name="preview">
<img src="./images/great-wave.jpg" alt="Hokusai’s blue wave curls above a distant Mount Fuji." width="1686" height="1155" loading="lazy" />
</slot>

## [One mountain, three points of view](./images.demo.md)

Compare three Hokusai prints, look closer at the details, and discover how a crop changes the story.

</example-card>

---

## At the worktable

Take a closer look at the elements behind a learning page. These short
references explore the building blocks of the examples above.

- [Callouts](./callouts.demo.md) — make room for a note, a question, or a useful aside.
- [Code](./code-highlight.demo.md) — share a readable example that others can copy and try.
- [Form controls](./form-controls.demo.md) — try native fields, choices, validation, and field states.
- [Math](./math.demo.md) — connect logic and mathematical notation with code.
- [Tables](./tables.demo.md) — bring related ideas together for comparison.
- [Themes](./theme-gallery.demo.md) — explore different ways to present the same material.
