From 9889416b8c8d841e5e9e6800d217bf74539b0cb3 Mon Sep 17 00:00:00 2001 From: Doxa Maps Date: Mon, 28 Sep 2026 00:59:32 +0000 Subject: [PATCH] =?UTF-8?q?Local=20is=20the=20default=20and=20needs=20no?= =?UTF-8?q?=20configuration=20=E2=80=94=20reverting=20the=20team-database?= =?UTF-8?q?=20wording?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Driver 01:10Z via dx-shepherd: the DEFAULT is everything LOCAL, zero config. A fresh clone plus `bun run dev` gives the Studio, dictation, hot reload and a local database, and never reaches a remote database or Docker. The team database is OPT-IN. My 674d5655 said the opposite — that most teams point every laptop at the shared one and the local one is "the fallback". That wording came from repo (END-REPO-PBDOC) and was correct when they gave it; the decision moved the same day. Inverted here: local is the default and the opt-in line is what needs explaining, not the other way round. ⚠ AND THE TABLE ABOVE IT WOULD HAVE KEPT SAYING THE OLD THING. Its middle row read "the team — this is usually the default", six lines from a section now saying the opposite. Fixed in the same pass: the laptop row is marked as the default, the shared row as opt-in. Third time in this file that a line has survived an edit around it and quietly stopped agreeing with the prose — the only way to catch it is to re-read what you did NOT change. Also states the zero-config claim explicitly where a newcomer meets it first ("That is the whole setup. Nothing to configure, no server to reach, no Docker"), because "everything is local" and "you have nothing to set up" are different promises and the Driver is making the second. Cross-links CLOUD-DEVELOPMENT-ENVIRONMENT.md for people whose agent runs on a server, with "most people do not need it" — that doc is next and its exact env names are with repo. --- documentation/HOWTO-join-the-table.md | 27 ++++++++++++++++----------- 1 file changed, 16 insertions(+), 11 deletions(-) diff --git a/documentation/HOWTO-join-the-table.md b/documentation/HOWTO-join-the-table.md index 497ae0d02..af5a5c59a 100644 --- a/documentation/HOWTO-join-the-table.md +++ b/documentation/HOWTO-join-the-table.md @@ -25,8 +25,12 @@ bun install bun run dev ``` -You get the Plugin Studio, hot reload on your own edits, and a local database with your own test data. Break -it, reset it, fill it with nonsense — it is yours. +That is the whole setup. **Nothing to configure**, no server to reach, no Docker. You get the Plugin +Studio, dictation, hot reload on your own edits, and a local database with your own test data. Break it, +reset it, fill it with nonsense — it is yours. + +If your coding agent runs on a server rather than on your laptop, there is a second way to work — +see [CLOUD-DEVELOPMENT-ENVIRONMENT.md](./CLOUD-DEVELOPMENT-ENVIRONMENT.md). Most people do not need it. ### 2. `main` — the truth @@ -117,8 +121,8 @@ There are three databases. You work against one of the first two — never the t | Where | What is in it | Who touches it | |---|---|---| -| Your laptop | your own sandbox data | you, freely | -| The team's shared one | the team's shared test data | the team — this is usually the default | +| Your laptop | your own sandbox data | you, freely — **this is the default** | +| The team's shared one | the team's shared test data | the team — opt-in, see below | | Production | what the public sees | nobody directly | **You never publish a database.** Not yours, not anyone's. What travels is the *shape* — the tables and @@ -134,19 +138,20 @@ live config did not match the repo, you already know why. ### Which one your laptop talks to -Most teams point every laptop at the **shared** one, so you are all working against the same test data. -Put this in `.env.local`: +**By default, your own.** You do not configure anything. The first time you run `bun run dev` it starts a +database on your laptop, keeps its data in `.pb/`, and gives you an admin screen at `/api/pb/_/`. A fresh +clone plus `bun run dev` is the whole setup — no remote server, no Docker, nothing to sign into. + +If your team wants everyone working against the *same* test data instead, that is opt-in. Add one line to +`.env.local`: ``` DX_PB_URL=https:///pb ``` You sign in with the same team account you use for everything else — there is no separate password. Ask -whoever set up your team for the address if you do not have it. - -**Leave it unset and you get a private one instead.** The first time you run `bun run dev` it downloads and -starts a database on your laptop, with its data in `.pb/`, and you can open its admin screen at -`/api/pb/_/`. That is the fallback, and it is a fine way to work while you are finding your feet. +whoever set up your team for the address. Leave the line out and you stay on your own local one, which is +the right place to be while you are finding your feet. The only other thing here is `DX_PB_PORT`, which you set only if the log says port 8090 is already in use.