docs: link the live component gallery
The playground is now published at
https://birko-framework.github.io/Birko.Web.Playground/, which makes it the only
thing in this wiki a reader can try without installing anything -- so it goes
where somebody deciding whether Birko suits them will actually see it: a callout
at the top of Web UI, a line on Home above the shared-projects explanation, and
the persistent sidebar.
birko
committed
Sep 19, 2026
docs: correct the import advice, which was true in spirit and false as written
Home.md said "You cannot hand-pick a few projects" and pointed every reader at
the 163-import compile gate. The Sandbox reaches ten layers -- stores, SQL,
migrations, caching, workflow, jobs, health, REST, GraphQL, security -- with 38,
so the absolute form is measurably false, and following it makes every consumer
carry nearly the whole framework.
What was actually true is the direction of travel: start from a list that
compiles and delete, rather than adding one project at a time and discovering
the graph one compiler error at a time. Both pages now say that, and bracket the
range with the two real references (38 and 163) so a reader can pick the end
they would rather work from.
birko
committed
Sep 18, 2026
Home + Getting Started: a usage guide grounded in verified examples
Every snippet was compiled and run against the current framework before being
written down, rather than copied from existing docs - several of which are stale
and are named as such on the Getting Started page.
The headline finding is that you cannot hand-pick .projitems imports: ten rounds
of adding one project at a time still had not closed, because the graph pulls
models, view-models, serialization and rules in behind the SQL stores. The guide
therefore tells people to copy the Sandbox aggregator's 163-import list, which is
proven to compile, rather than building one up.
birko
committed
Sep 18, 2026