Skip to content

docs(quickstart): re-transcribe both boot samples against CLI 17.5.0 #288

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
hotlong merged 1 commit into from
Oct 1, 2026
Merged

docs(quickstart): re-transcribe both boot samples against CLI 17.5.0 #288

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
31 changes: 17 additions & 14 deletions content/docs/quickstart.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,21 +53,21 @@ You'll see:
Mode: production
Driver: SqlDriver(better-sqlite3) → ~/.objectstack/data/objectstack.db
Tenancy: single
Plugins: 30 loaded
Plugins: 31 loaded

Press Ctrl+C to stop
```

That's it. You're running ObjectOS.

That block is transcribed from `@objectstack/cli` 17.4.0 booting an empty
That block is transcribed from `@objectstack/cli` 17.5.0 booting an empty
kernel. Home paths show as `~/…` — the CLI prints yours expanded. Your own boot
also prints a `No objectstack.config.ts or artifact found` line before the
server starts, plus startup advisories (local storage driver, dev crypto key,
boot diagnostics) and the full list of loaded plugin names, both of which
depend on your environment. It also logs two SQL-driver errors that do not stop
the server: a `DATABASE_ERROR` for a missing `_objectstack_sequences` table, and
an `Insert operation failed` on `sys_oauth_resource` with a stack trace.
depend on your environment. It also logs a SQL-driver warning,
`Paged read of 'sys_migration' is NOT deterministic`, and a `DATABASE_ERROR`
for a missing `sys_migration` table, neither of which stops the server.

### What's running

Expand Down Expand Up @@ -162,15 +162,15 @@ You'll see:

◆ Compile
────────────────────────────────────────
✓ Build complete (97ms)
✓ Build complete (175ms)

Data: 1 Objects 3 Fields
UI: 0 Apps
Logic: 0 Flows
Security: 0 Positions 0 Permissions
Runtime: 0 plugins

Artifact: my-app/dist/objectstack.json (1.8 KB)
Artifact: my-app/dist/objectstack.json (1.9 KB)

→ Starting dev server (local mode)...
🎯 Environment ID: env_local
Expand All @@ -187,27 +187,30 @@ You'll see:

🔑 Dev admin: admin@objectos.ai / admin123
seeded on empty DB · dev only — do not use in production
platform admin — Setup, Studio and every record, but NO app-declared capability, so
an app that gates navigation on requiredPermissions may show it an empty menu; grant
it a permission set under Setup → Users, or sign in as an account your app seeds

Config: objectstack.config.ts
Mode: development
Driver: SqlDriver(better-sqlite3) → my-app/.objectstack/data/objectstack.db
Tenancy: single
Plugins: 30 loaded
Plugins: 36 loaded

Press Ctrl+C to stop
```

That block is transcribed from `pnpm dev` on a scaffold created by
`@objectstack/cli` 17.4.0. Project paths show as `my-app/…` — the CLI prints
`@objectstack/cli` 17.5.0. Project paths show as `my-app/…` — the CLI prints
yours expanded, and the `Build complete` timing is whatever the transcribing
machine measured, so yours will differ. Your own run also prints pnpm's script
header above the block, per-step compile progress, startup advisories
(configuration load, dev secret-field crypto), the full list of loaded plugin
names, and an MCP connection trailer. A separate process prints that trailer,
so it usually follows `Press Ctrl+C to stop` but can land inside the banner. The
run also logs SQL-driver errors that do not stop the server: a `DATABASE_ERROR`
for a missing `_objectstack_sequences` table (printed twice), and an
`Insert operation failed` on `sys_oauth_resource` with a stack trace.
names, boot diagnostics, and an MCP connection trailer. A separate process
prints that trailer, so it usually lands inside the banner, often interleaved
line by line with it. The run also logs a SQL-driver warning,
`Paged read of 'sys_migration' is NOT deterministic`, and a `DATABASE_ERROR`
for a missing `sys_migration` table, neither of which stops the server.

Note the dev server asks for port **3000**, the same port `os start` uses. If
that port is taken it binds the next free one and says so:
Expand Down
Loading