# Datastar docs (v1.0.0-beta.11)

Version-matched documentation for the Datastar bundle loaded by this project.

## Why vendor the docs?

The live docs at [data-star.dev](https://data-star.dev/) track an unreleased
newer version. They describe attribute syntax (`data-on:click`) and SSE event
names (`datastar-patch-elements`) that **do not work in v1.0.0-beta.11** — the
version pinned in `pages/layout.rkt`.

These vendored copies are pulled directly from the Datastar GitHub repo at
tag `v1.0.0-beta.11`, so they match the CDN bundle exactly.

## Quick reference for this project

Most-used pages while building components:

| What you need | File |
|---------------|------|
| Attribute names: `data-signals`, `data-show`, `data-on-click`, `data-text`, modifiers | [reference/attribute_plugins.md](reference/attribute_plugins.md) |
| Actions: `@get()`, `@post()`, signal passing, options | [reference/action_plugins.md](reference/action_plugins.md) |
| SSE event format: `datastar-merge-fragments`, `datastar-execute-script`, data lines | [reference/sse_events.md](reference/sse_events.md) |
| Expression language: `$foo`, `evt`, `this`, computed signals | [guide/datastar_expressions.md](guide/datastar_expressions.md) |
| First-time walkthrough | [guide/getting_started.md](guide/getting_started.md) |

## Refetching after a version bump

When upgrading Datastar:

1. Edit `DATASTAR_VERSION` in `fetch-docs.sh`
2. Update the CDN URL in `pages/layout.rkt` to match
3. Run `./fetch-docs.sh`
4. Review `reference/attribute_plugins.md` and `reference/sse_events.md` for breaking changes
5. Update `racket-plan-c-rcnt-demo-spec.md` "Datastar integration notes" if anything changed

## If something "doesn't work"

Read [VERSION.md](VERSION.md) for the debugging protocol. In short: trust
these markdown files over anything on data-star.dev.