docs: add quickstart (#811)

Author: coodos

docs/docs/Post Platform Guide/dev-sandbox.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 4
+sidebar_position: 2
 ---
 
 # Using the Dev Sandbox
@@ -17,7 +17,7 @@ pnpm install
 pnpm dev:core
 ```
 
-The sandbox is available at **http://localhost:8080**. See **QUICKSTART.md** in the repo root for prerequisites and environment variables.
+The sandbox is available at **http://localhost:8080**. See [Local Dev Quick Start](/docs/Post%20Platform%20Guide/local-dev-quick-start) for prerequisites and environment variables.
 
 ### Option 2: Run the sandbox only
 

docs/docs/Post Platform Guide/getting-started.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 3
 ---
 
 # Getting Started with Platform Development

docs/docs/Post Platform Guide/local-dev-quick-start.md

@@ -0,0 +1,117 @@
+---
+sidebar_position: 1
+---
+
+# Local Dev Quick Start
+
+Run **Postgres** and **Neo4j** in Docker, then start the core services and dev-sandbox with one script.
+
+## Prerequisites
+
+- **Docker** (for Postgres and Neo4j)
+- **Node.js 18+** and **pnpm**
+- **.env** in the repo root (copy from `.env.example` if present, or set the variables below)
+
+## Environment
+
+Create or edit `.env` in the repo root. Minimum for this stack:
+
+```bash
+# Postgres (used by registry)
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=postgres
+REGISTRY_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/registry
+
+# Neo4j (used by evault-core)
+NEO4J_USER=neo4j
+NEO4J_PASSWORD=your-password
+
+# So the sandbox and evault-core can talk to registry/provisioner
+PUBLIC_REGISTRY_URL=http://localhost:4321
+PUBLIC_PROVISIONER_URL=http://localhost:3001
+REGISTRY_SHARED_SECRET=dev-secret-change-me
+PUBLIC_EVAULT_SERVER_URI=http://localhost:4000
+```
+
+## One-command start
+
+From the repo root:
+
+```bash
+pnpm install
+pnpm dev:core
+```
+
+Or run the script directly:
+
+```bash
+chmod +x scripts/start-dev.sh
+./scripts/start-dev.sh
+```
+
+This will:
+
+1. Start **Postgres** (port 5432) and **Neo4j** (7474, 7687) via `docker-compose.databases.yml`
+2. Wait for Postgres to be ready
+3. Start **registry** (4321), **evault-core** (3001 provisioning, 4000 GraphQL), and **dev-sandbox** (8080) in parallel
+
+Stop with `Ctrl+C`. To stop only the databases:
+
+```bash
+pnpm docker:core:down
+```
+
+## Ports
+
+| Service         | Port(s)    | Notes                    |
+|-----------------|------------|--------------------------|
+| Postgres        | 5432       |                          |
+| Neo4j HTTP      | 7474       |                          |
+| Neo4j Bolt      | 7687       |                          |
+| Registry        | 4321       |                          |
+| evault-core     | 3001, 4000 | Provisioning + GraphQL   |
+| **Dev sandbox** | **8080**   | W3DS dev sandbox UI      |
+
+Open **http://localhost:8080** for the dev sandbox (provision, W3DS flows, sign).
+
+## Optional: databases only
+
+To run only Postgres and Neo4j (e.g. you run the app services yourself):
+
+```bash
+pnpm docker:core
+```
+
+Or:
+
+```bash
+docker compose -f docker-compose.databases.yml up -d
+```
+
+Stop with:
+
+```bash
+pnpm docker:core:down
+```
+
+## Troubleshooting
+
+**Neo4j "encryption setting" or connection refused:** The stack uses **Neo4j 4.4** (unencrypted Bolt by default). If you previously used Neo4j 5.x, remove the old data and recreate:
+
+```bash
+docker compose -f docker-compose.databases.yml down
+docker volume rm metastate_neo4j_data 2>/dev/null || true
+docker compose -f docker-compose.databases.yml up -d
+pnpm dev:core
+```
+
+Otherwise ensure `.env` has:
+
+```bash
+NEO4J_URI=bolt://127.0.0.1:7687
+NEO4J_USER=neo4j
+NEO4J_PASSWORD=your-password
+```
+
+For full Docker setups and all platform services, see the main `README` in the repo root.
+

docs/docs/Post Platform Guide/mapping-rules.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 4
 ---
 
 # Mapping Rules

docs/docs/Post Platform Guide/webhook-controller.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 3
+sidebar_position: 5
 ---
 
 # Webhook Controller Guide