Skip to content

docs: name the 16k measurement's host "the bundled example CRM"#9304

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
os-zhuang merged 1 commit into from
Aug 17, 2026
Merged

docs: name the 16k measurement's host "the bundled example CRM" #9304

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -140,10 +140,10 @@ The reason this works is the same reason TypeScript was the right host language:
**an agent's errors become located, corrective text it can read and fix itself**,
in seconds — instead of a silent runtime failure nobody traces back.

The other half is size. The CRM in this repo — [`examples/app-crm`](./examples/app-crm):
The other half is size. The bundled example CRM — [`examples/app-crm`](./examples/app-crm):
six objects, views, a dashboard, a lead-conversion flow, permission sets, actions,
translations — is **31 files, 1,792 lines, roughly 16k tokens**. That's the whole
business system, in about 8% of a 200k-token context window. Count it yourself:
example app, in about 8% of a 200k-token context window. Count it yourself:

```bash
find examples/app-crm/src -name '*.ts' -not -name '*.test.ts' | xargs cat | wc -l
Expand Down
4 changes: 2 additions & 2 deletions content/docs/concepts/metadata-driven.mdx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -211,7 +211,7 @@ React Flutter

A simple CRUD feature that takes ~300 lines of hand-written code is ~30 lines of
metadata. But per-feature ratios are the least interesting part. Here is the
measurement that matters — the CRM bundled in this repo
measurement that matters — the bundled example CRM
([`examples/app-crm`](https://github.com/objectstack-ai/objectstack/tree/main/examples/app-crm):
six objects, views, a dashboard, a lead-conversion flow, permission sets,
actions, translations):
Expand All@@ -222,7 +222,7 @@ actions, translations):
| Lines | 1,792 |
| Approximate tokens | ~16,000 |

That's the **whole business system** — about 8% of a 200k-token context window.
That's the **whole example app** — about 8% of a 200k-token context window.
Count it yourself:

```bash
Expand Down
6 changes: 3 additions & 3 deletions content/docs/getting-started/how-ai-development-works.mdx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -26,10 +26,10 @@ build the thing I actually meant?*
## Why it's fast

A typical enterprise app spreads CRUD, forms, queries, permissions, and API glue
across dozens of files. ObjectStack keeps only the part that's yours: the CRM
bundled in this repo — six objects, views, a dashboard, a lead-conversion flow,
across dozens of files. ObjectStack keeps only the part that's yours: the bundled
example CRM — six objects, views, a dashboard, a lead-conversion flow,
permission sets, actions, translations — is **1,792 lines across 31 files, about
16k tokens**. That's the entire business system, not a module of it.
16k tokens**. That's the whole example app, not a module of it.

The point isn't lines of code; it's **fit in an agent's context window.** When the
entire business system is small, typed, and declarative, an agent can load it
Expand Down
Loading