Skip to content

Commit 2b33a87

Browse files
phernandezclaude
andcommitted
docs: corrections from live production verification
Verified against app.basicmemory.com: the seeded Getting Started project, /notes route, Settings tabs, Activity feed, Explore graph, feedback button, and support email all match the docs. Three things didn't and are fixed: - "Settings -> General -> Show onboarding" doesn't exist; the replay surface is the Help Center (account menu -> Help) with the Connect Your AI Tool walkthrough, endpoint copy button, and test prompt - There is no workspace selector dropdown — each workspace (personal and teams) is its own sidebar section; teams pages and the web app layout table now say so - The graph entry point is Graph in the sidebar with Project / Structured / Explore tabs (Explore is 2D/3D); themes are saved per-browser, which the themes page now notes Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 089d260 commit 2b33a87

8 files changed

Lines changed: 18 additions & 15 deletions

File tree

content/01.start-here/2.quickstart-cloud.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ code: |
2121

2222
Sign up at [basicmemory.com](https://basicmemory.com/?utm_source=docs&utm_medium=docs&utm_campaign=quickstart-cloud). You'll need an active subscription to use the MCP endpoint.
2323

24-
After sign-up, the app prepares your workspace and opens a seeded **Getting Started** project — a short tutorial you can read (and edit) in place. A floating onboarding guide walks you through the same steps as this page: connect your agent, write your first note, and watch it appear live. You can replay it anytime from **Settings → General → Show onboarding**.
24+
After sign-up, the app prepares your workspace and opens a seeded **Getting Started** project — a short tutorial you can read (and edit) in place. A floating onboarding guide walks you through the same steps as this page: connect your agent, write your first note, and watch it appear live. The in-app **Help Center** (account menu → Help) keeps the same walkthrough available anytime — your MCP endpoint, setup guides, and a quick test prompt.
2525

2626
---
2727

content/03.cloud/02.web-app.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ The app is organized into three panes:
1818

1919
| Pane | Contents |
2020
|------|----------|
21-
| **Sidebar** | Workspace selector (personal and teams), project and folder tree, search, your account avatar |
21+
| **Sidebar** | Pinned notes, your workspaces (personal and teams) with their project trees, search, Graph and Activity, your account menu |
2222
| **Note list** | Notes in the current folder or project, grouped by date |
2323
| **Note detail** | The selected note, opened ready to edit |
2424

@@ -62,7 +62,7 @@ The **Activity** view in the sidebar keeps you aware of what's happening across
6262

6363
## Explore the graph
6464

65-
The **Explore** view renders your knowledge graph in 3D notes as nodes, relations as links between them. It rotates gently until you interact: drag to orbit, scroll to zoom, and click a node to open the note.
65+
Open **Graph** in the sidebar for the Knowledge Graph, then pick a view: **Project** (cards), **Structured**, or **Explore** — a 2D/3D rendering of your knowledge graph, notes as nodes, relations as links. Drag to orbit, scroll to zoom, click a node to open the note, and filter by relation type or search for a note to focus on.
6666

6767
---
6868

@@ -132,7 +132,7 @@ Access settings from the user menu (your avatar at the bottom of the sidebar) or
132132

133133
| Section | What it does |
134134
|---------|--------------|
135-
| **General** | Account and profile settings, themes and color mode, plus **Show onboarding** to replay the guided tour |
135+
| **General** | Account and profile settings, Look & Feel (mode, theme, note list), and editor preferences |
136136
| **Teams** | Your [teams and workspaces](/teams/about) at a glance |
137137
| **Members** | Invite and manage [team members, roles, and invitations](/teams/members-and-roles) |
138138
| **Billing** | Manage payment and [subscription seats](/teams/seats-and-billing) |

content/03.cloud/07.themes.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ Use the **Mode** control to choose **Light**, **Dark**, or **System**. System fo
1818
The **Theme** control shows a row of color swatches — each previews a theme's palette, labeled with the theme's name. Click a swatch to apply it instantly, no save needed.
1919

2020
- Themes and mode are independent: every theme has coordinated colors for both light and dark, so switching mode keeps your theme.
21+
- Theme choices are saved locally in this browser — pick your theme on each device you use.
2122
- The theme applies across the whole app — sidebar, editor, preview, and settings.
2223

2324
Try a few — clicking around is faster than reading about them.

content/04.teams/1.about.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Your account can have more than one workspace. Each keeps its own projects, note
2121
| **Personal** | Just you | Your personal cloud subscription and notes |
2222
| **Team** | Your team | Shared projects, members, roles, and seats |
2323

24-
Switch between your personal and team workspaces using the workspace selector in the app. Projects and notes are scoped to the workspace you're in; local projects stay on your machine, reachable from the CLI and MCP alongside them.
24+
In the app, each workspace — personal and every team — appears as its own section in the sidebar. Projects and notes are scoped to the workspace you're in; local projects stay on your machine, reachable from the CLI and MCP alongside them.
2525

2626
---
2727

content/04.teams/5.join-a-team.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ On first sign-in, your account is linked to the pending membership, and you beco
2626

2727
## 2. Find the projects
2828

29-
Switch to the team workspace with the **workspace selector** in the sidebar — the sidebar then shows the team's projects. Open one to see its folders and notes.
29+
Your team appears as its own section in the sidebar, alongside your personal workspace, with its projects listed underneath. Open one to see its folders and notes.
3030

3131
Your **role** determines what you can do — from read-only **Viewer** up to **Owner**, with Editor, User Admin, and Admin tiers in between. The full capability table is on [Members and Roles](/teams/members-and-roles).
3232

content/04.teams/6.copy-between-workspaces.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ In the app, switch to the **source workspace** and open **Settings → Projects*
3434

3535
### Switch to the target
3636

37-
Switch to the **target workspace** in the workspace selector.
37+
Find the **target workspace's** section in the sidebar.
3838

3939
### Import the ZIP
4040

content/08.integrations/0.index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ description: Choose an AI client or extension and connect it to Basic Memory.
66
Basic Memory is most useful when the AI tools you already use can read and write the same shared knowledge base. Start with the tool you use most, then connect others to the same workspace as needed.
77

88
::tip
9-
For Basic Memory Cloud, the fastest path is the **Connect your agent** walkthrough in the web app's onboarding guide and Help sheet (replay it anytime via **Settings → General → Show onboarding**) — it covers Claude, Codex, ChatGPT, and other MCP tools, connecting to the hosted MCP endpoint:
9+
For Basic Memory Cloud, the fastest path is the **Connect Your AI Tool** walkthrough in the web app's Help Center (account menu → **Help**) — it has your MCP endpoint with a copy button, Claude and ChatGPT setup guides, and a quick test prompt:
1010

1111
```text
1212
https://cloud.basicmemory.com/mcp

docs/todo.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,15 @@ Remaining, only if desired:
1010
- [ ] Optional new captures: onboarding popup / Activity view / Explore graph / partner portal — pages describe these in prose today and don't require images
1111
- [ ] When capturing anything new, record source screen, date, theme, and owning page in `docs/screenshots.json` (the checker validates manifest entries)
1212

13-
## Verify against production
14-
15-
- [ ] **July-1 onboarding batch deployed?** `quickstart-cloud.md` and `web-app.md` now describe the seeded Getting Started project, onboarding popup, Show-onboarding replay, Activity feed with agent writes, and Explore graph. Confirm these are live at app.basicmemory.com before production docs deploy.
16-
- [ ] `app.basicmemory.com/notes` route used in quickstart step 5 — confirm it's the canonical notes URL
17-
- [x] **Themes page** — rewritten around the preset system (Settings → General → Look & Feel: Mode + theme swatches); the removed custom-CSS/TweakCN feature and localStorage persistence claims are gone. Capture a fresh Look & Feel screenshot when doing the screenshot pass.
18-
- [ ] `bm project ls --name <project>` in `cloud/03.cloud-sync.md` command reference — confirm the subcommand exists (everything else on that page is source-verified)
19-
- [ ] `api-keys.md`: curl example against `https://cloud.basicmemory.com/api/v2/projects` — confirm path
13+
## Verify against production — done 2026-07-03
14+
15+
Verified live at app.basicmemory.com (logged-in session):
16+
- [x] July-1 onboarding batch deployed: seeded Getting Started project (all workspaces), Help Center at /help with Connect Your AI Tool (endpoint + copy, Claude/ChatGPT guides, test prompt), Activity feed (sidebar popover + View all), Explore Graph (Graph → Project/Structured/Explore tabs, 2D/3D)
17+
- [x] `/notes` route confirmed canonical
18+
- [x] Settings nav matches docs (General…Version); Look & Feel = Mode + Note list + Theme swatches (saved per-browser — docs updated)
19+
- [x] `bm project ls --name` — source-verified (project.py:1240)
20+
- [x] `api/v2/projects` — source-verified (gateway path test + v2 project router)
21+
- Corrections applied to docs: "Show onboarding" control doesn't exist (Help Center is the replay surface); workspaces are sidebar *sections*, not a selector dropdown; graph entry is **Graph** with Explore as a tab
2022

2123
## Verify against external products (fast-moving UIs)
2224

0 commit comments

Comments
 (0)