also looking at this
Add BunPress guide and pre-E2E quality gates
#6
318 files
+2174
-70006
Review threads live on the whole diff, not on one commit, so none are shown here - a thread's line means something in the branch's final form, and painting it into an intermediate step would put it on code it is not about.
| @@ -19,10 +19,13 @@ CommsHQ requires Bun 1.3 or newer and uses only packages owned by the Stacks eco | ||
| 19 | 19 | |
| 20 | 20 | ```bash |
| 21 | 21 | bun install |
| 22 | ./buddy migrate:fresh --seed | |
| 22 | ./buddy migrate --auth | |
| 23 | ./buddy seed | |
| 23 | 24 | ./buddy dev |
| 24 | 25 | ``` |
| 25 | 26 | |
| 27 | Set `COMMSHQ_OWNER_PASSWORD` in your local `.env` before seeding so the owner account and workspace are created. `./buddy migrate:fresh --seed` drops all tables and is only for a disposable development database. | |
| 28 | ||
| 26 | 29 | Run the full local quality gate with: |
| 27 | 30 | |
| 28 | 31 | ```bash |
| @@ -17,11 +17,16 @@ description: Run CommsHQ locally and learn the first end-to-end workflow. | ||
| 17 | 17 | git clone https://github.com/stacksjs/commshq.git |
| 18 | 18 | cd commshq |
| 19 | 19 | bun install |
| 20 | ./buddy migrate:fresh --seed | |
| 20 | ./buddy migrate --auth | |
| 21 | ./buddy seed | |
| 21 | 22 | ./buddy dev |
| 22 | 23 | ``` |
| 23 | 24 | |
| 24 | The seeded database supplies representative contacts, segments, campaigns, content, automations, commerce events, and reputation data. | |
| 25 | Set `COMMSHQ_OWNER_PASSWORD` to a password you choose in your local `.env` before running `./buddy seed`. You can also set `COMMSHQ_OWNER_EMAIL`; otherwise the owner seeder uses `chris@stacksjs.com`. Without the password, the owner seeder skips account and workspace creation outside production, so there is no owner account to sign in with. In production it fails instead of creating an account with an empty password. | |
| 26 | ||
| 27 | The model seeders can create sample records, but they do not replace the owner bootstrap or prove that every workflow below is connected in the dashboard. Start by signing in with the owner account you configured, then inspect the seeded workspace and available API surfaces. | |
| 28 | ||
| 29 | `./buddy migrate:fresh --seed` drops every table. Use it only when you deliberately want to reset a disposable development database, not as the normal setup path for an existing checkout. | |
| 25 | 30 | |
| 26 | 31 | ## Learn one complete flow |
| 27 | 32 | |
| @@ -24,7 +24,7 @@ features: | ||
| 24 | 24 | |
| 25 | 25 | ## Choose a path |
| 26 | 26 | |
| 27 | - Use the [quick start](/getting-started) to run CommsHQ and inspect the seeded workspace. | |
| 27 | - Use the [quick start](/getting-started) to create an owner workspace and inspect the available sample data. | |
| 28 | 28 | - Establish clean identity and permission data with [contacts and consent](/audience/contacts-consent). |
| 29 | 29 | - Build an audience with [segments and imports](/audience/segments-imports). |
| 30 | 30 | - Learn the delivery lifecycle in [email and SMS campaigns](/campaigns/email-sms). |