docs(base44-cli): local data persistence & seeding for base44 dev - #140
Draft
netanelgilad wants to merge 1 commit into
Draft
docs(base44-cli): local data persistence & seeding for base44 dev#140netanelgilad wants to merge 1 commit into
netanelgilad wants to merge 1 commit into
Conversation
…4 dev
Documents the upcoming local-data feature of the Base44 CLI:
- references/dev.md: persistence-by-default (.base44/ state dir, survives
restarts and entity edits, safe to delete), the --fresh flag, the
seed-on-first-boot lifecycle, and pointers to the new reference doc
- references/local-data.md (new): full guide — state dir layout, dev.json
+ base44 dev status, seed fixtures (users.jsonc / <Entity>.jsonc) with
the upsert idempotency contract, base44 dev seed/reset, programmatic
base44/seed.ts (ctx.base44 / ctx.remote({dataEnv}) / Deno), base44 data
pull/dump with flags and JSON output shapes, and agent guidance
(--json, --force in non-interactive mode, instance discovery)
- SKILL.md: seed/ dir, seed.ts and .base44/ in the project layout,
seedDir in the config.jsonc schema, new dev status/seed/reset and
data pull/dump command index entries, workflow and troubleshooting notes
Feature requires CLI version >= 0.0.x (upcoming release).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MdYwKUei4xxBZTZcBUmbaw
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents the upcoming Base44 CLI local-data feature in the
base44-cliskill. Companion to the implementation PR in base44/cli (same branch name); merge when that release ships.What changed
references/local-data.md— full guide:.base44/state dir +dev.json+base44 dev status; seed fixtures (base44/seed/users.jsonc,<Entity>.jsonc) with the upsert idempotency contract;base44 dev seed [--replace]/base44 dev reset; programmaticbase44/seed.ts(ctx.base44local service-role client,ctx.remote({dataEnv})remote factory, Deno requirement);base44 data pull/data dump; agent guidance (--json,--force, instance discovery viadev.jsonwith stale-pid semantics).references/dev.md— persistence-by-default behavior,--fresh, seed-on-first-boot lifecycle, schema-edits-preserve-data, app-id mismatch guard, worktree isolation.SKILL.md— project layout gainsbase44/seed/+base44/seed.ts+ gitignored.base44/;seedDiradded to the config.jsonc table; new command rows (dev status/seed/reset,data pull/dump); troubleshooting entries.CLI version is a "0.0.x (upcoming)" placeholder — set the real version at release.
🤖 Generated with Claude Code
https://claude.ai/code/session_01MdYwKUei4xxBZTZcBUmbaw
Generated by Claude Code