Idea detail
gs_04_first_base
reqlan rq/marketing_and_media/tutorials.rq:565
block
Summary
Audience: users with a small linked graph who have not yet marked a base.
Outcome: create a base ( `.reqlan` ); explain that a base is the boundary of one ideas graph and owns the ideas index; know extension install ≠ base create.
Runtime: 5 – 6 min.
Demo: `reqlan-tutorials-demo` with `reqs/product.rq` containing linked `welcome_flow` ↔ `onboarding_checklist` ( and optional `account_model` ). No `.reqlan` folder. Activity bar or Ideas Summary shows empty / create-base prompt. Caret on any idea in `product.rq`.
Related: base base_detail create_base_onboarding base_installation installation extension_installation
Attributes
| Key | Value |
|---|---|
| example | ``` // After create-base, Explorer shows: reqlan-tutorials-demo/ .reqlan/ config.json .rqignore ideas-index.sqlite // appears once indexing activates — tooling memory reqs/ product.rq // Do not hand-edit ideas-index.sqlite. ``` |
| script | SCR: Activity bar reqlan icon — empty state CTA "Create base", or Command Palette: `Reqlan: Create Base`. Explorer: `reqs/product.rq` present, no `.reqlan` yet. VO: Installing the extension puts reqlan in the editor. It does not create a base. A base is a folder that owns a `.reqlan` directory — the boundary of one ideas graph. SCR: Sticky: "I installed the extension — why is the activity bar empty?" Point at missing `.reqlan` in Explorer. VO: Extension install and base create are two layers. Until the folder has a marker, there is no index boundary for neighbourhood views to bind to. SCR: Accept create-base at the workspace-folder root (`reqlan-tutorials-demo`). Explorer refreshes — expand `.reqlan`: `config.json`, `.rqignore`. Do not open the sqlite file. VO: That marker is shared application memory. Config and ignore rules live here. The ideas index appears under `.reqlan` once indexing activates — treat it as tooling memory, not a document you edit. SCR: Glance at activity bar or status: idea counts / readiness updating. Return to `product.rq` — caret on `welcome_flow`. VO: Same ideas you already wrote — now the tooling knows which graph they belong to. SCR: Optional ten seconds: terminal in a scratch empty folder — `npx reqlan init` — show identical `.reqlan` tree, then close terminal and return to demo folder. VO: Editor create-base and CLI init seed the same marker. Pick the host that fits the moment. SCR: Whiteboard beat — dashed box labelled "nested base" inside a parent folder. Do not create one live. VO: One base is enough for day one. Nested bases exist for larger trees — we name them later in Concepts. VO: Try this: confirm `.reqlan` is visible in Explorer, open `product.rq`, leave the caret on an idea, and watch the activity bar populate. SCR: End card → next: "Neighbourhood in the activity bar". |
| slides | { id title transition fade background brand-dark kicker Get started · 04 heading Your first base asset logo notes Installing the extension puts reqlan in the editor. It does not create a base. }, { id two-layers transition none background brand-contrast heading Extension install ≠ base create body Extension: language support in the editor. Base: .reqlan marker + ideas index boundary. notes Until the folder has a marker, neighbourhood views have nothing to bind to. }, { id create transition slide background brand-panel heading Create Base at workspace root body Command Palette: Reqlan: Create Base — or accept the activity-bar CTA. notes Accept at reqlan-tutorials-demo root, not a subfolder. }, { id marker transition fade background brand-panel heading A base owns .reqlan body config.json and .rqignore are yours. ideas-index.sqlite is tooling memory. code_lang txt code reqlan-tutorials-demo/.reqlan/ notes Do not hand-edit the index file — the tooling rebuilds it from your .rq sources. }, { id same-ideas transition fade background brand-panel heading Same ideas, now indexed body Reopen product.rq. Counts and neighbourhood views wake up. notes You did not rewrite anything — you marked the graph boundary. }, { id cli-parity transition none background brand-panel heading CLI parity code_lang bash code npx reqlan init body Seeds the same .reqlan tree in any empty folder. notes Editor and CLI share the same marker path. }, { id nested-teaser transition fade background brand-contrast heading Nested bases — later body One base is enough for day one. Child bases are separate graphs. notes We name nested boundaries in Concepts — do not create one on camera. }, { id try-this transition fade background brand-dark heading Try this body Confirm .reqlan exists. Open product.rq. Leave caret on an idea. fragments Next: Activity bar notes Watch the activity bar populate once the index activates. } |
Ancestor context
No ancestor chain recorded.
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| None | |||
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| ideaset_member | get_started_series | reqlan rq/marketing_and_media/tutorials.rq | — |
| ideaset_member | slide_decks | reqlan rq/marketing_and_media/tutorials.rq | — |
| references | demo_workspace | reqlan rq/marketing_and_media/tutorials.rq | gs_04_first_base |
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| references | base | base | |
| references | base_detail | base_detail | |
| references | base_installation | base_installation | |
| references | create_base_onboarding | create_base_onboarding | |
| references | extension_installation | extension_installation | |
| references | installation | installation |
Initialising graph…