clone

a deno framework for local-first web apps that open instantly, work offline and sync when users choose

docs: use the reserved @lofi-cat JSR scope in create commands

Dami committed 23b77fc
commit
23b77fc828ef739579af892b409e8a028616ac72
parent
1e2231588922c6863a39bb58d123f6da48d5b0fc
author
Dami <dami.etoile@gmail.com>
2 files changed, +18 -18
MREADME.md16++++++++--------
Mdocs/devx-contract.md20++++++++++----------
M README.md +8 -8
@@ -30,7 +30,7 @@ Built on [Jazz 2](https://jazz.tools) (CRDT data + sync) · [Preact](https://pre
3030 When every milestone below has landed, this is the entire onboarding experience:3131 3232 ```sh33-deno run -A jsr:@lofi/create my-app33+deno run -A jsr:@lofi-cat/create my-app3434 cd my-app3535 deno task dev3636 ```
@@ -90,13 +90,13 @@ is reported as _unavailable_ rather than faked, because the pinned API exposes n
9090 9191 ## Roadmap9292 93-| Milestone | Goal | Status |94-| ----------------------------- | ---------------------------------------------------------------------------------------------------- | -------------- |95-| **M0 — DevX contract** | Define the golden path, command surface, environment contract, and measurable acceptance criteria. | ✅ Done |96-| **M1 — Feasibility spikes** | Prove Jazz 2, Preact, OPFS, identity, Astro islands, and Deno behavior with go/no-go decisions. | ✅ Done |97-| **M2 — DevX vertical slice** | `create`, `dev`, `doctor`, diagnostics, inspector, and testing workflows around a reference app. | 🚧 In progress |98-| **M3 — Mobile PWA hardening** | Install, persistence, offline cold start, lifecycle recovery, and physical-device validation. | ⏳ Queued |99-| **M4 — Framework extraction** | Extract proven seams into `@lofi/*` packages; validate them through a second generated consumer app. | ⏳ Queued |93+| Milestone | Goal | Status |94+| ----------------------------- | -------------------------------------------------------------------------------------------------- | -------------- |95+| **M0 — DevX contract** | Define the golden path, command surface, environment contract, and measurable acceptance criteria. | ✅ Done |96+| **M1 — Feasibility spikes** | Prove Jazz 2, Preact, OPFS, identity, Astro islands, and Deno behavior with go/no-go decisions. | ✅ Done |97+| **M2 — DevX vertical slice** | `create`, `dev`, `doctor`, diagnostics, inspector, and testing workflows around a reference app. | 🚧 In progress |98+| **M3 — Mobile PWA hardening** | Install, persistence, offline cold start, lifecycle recovery, and physical-device validation. | ⏳ Queued |99+| **M4 — Framework extraction** | Extract proven seams into `@lofi-cat/*` packages; validate them through a second app. | ⏳ Queued |100100 101101 The definition of done for the whole prototype is the [north star](#the-north-star) journey passing102102 its contract budgets end-to-end, on real devices.
M docs/devx-contract.md +10 -10
@@ -30,7 +30,7 @@ This is the eventual product experience. The generator itself is M2 work and is
3030 deliverable.3131 3232 ```sh33-deno run -A jsr:@lofi/create my-app33+deno run -A jsr:@lofi-cat/create my-app3434 cd my-app3535 deno task dev3636 ```
@@ -116,15 +116,15 @@ These are product outputs, not claims that every command is implemented at Contr
116116 prototype must implement `dev`, `check`, `test`, `build`, and `preview`; `create` and the complete117117 `doctor` experience graduate in M2.118118 119-| Command | Success output must contain | Failure output must contain |120-| ------------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------- |121-| `deno run -A jsr:@lofi/create <name>` | Created path and exact `cd`/`deno task dev` next steps. | Conflicting input/path, unchanged-files guarantee, and corrective command. |122-| `deno task dev` | Usable URL plus storage, identity, sync, and PWA states. | Failed subsystem, developer impact, and one remediation. |123-| `deno task doctor` | Versioned capability/configuration table without values. | Invalid/unsupported item plus remediation; nonzero exit for blockers. |124-| `deno task check` | Checks run and concise pass summary. | First failing check and rerun command. |125-| `deno task test` | Suites, durations, and retained failure-artifact location. | Failing scenario and artifact location without fixed-sleep advice. |126-| `deno task build` | Output path, route count, and secret-scan result. | Failed internal tool/adapter and supported fallback action. |127-| `deno task preview` | Production URL and build identity. | Missing/stale build and exact build command. |119+| Command | Success output must contain | Failure output must contain |120+| ----------------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------- |121+| `deno run -A jsr:@lofi-cat/create <name>` | Created path and exact `cd`/`deno task dev` next steps. | Conflicting input/path, unchanged-files guarantee, and corrective command. |122+| `deno task dev` | Usable URL plus storage, identity, sync, and PWA states. | Failed subsystem, developer impact, and one remediation. |123+| `deno task doctor` | Versioned capability/configuration table without values. | Invalid/unsupported item plus remediation; nonzero exit for blockers. |124+| `deno task check` | Checks run and concise pass summary. | First failing check and rerun command. |125+| `deno task test` | Suites, durations, and retained failure-artifact location. | Failing scenario and artifact location without fixed-sleep advice. |126+| `deno task build` | Output path, route count, and secret-scan result. | Failed internal tool/adapter and supported fallback action. |127+| `deno task preview` | Production URL and build identity. | Missing/stale build and exact build command. |128128 129129 Example successful development output:130130