feat: cross platform quickstart (#813)

Author: coodos

.vscode/settings.json

@@ -8,7 +8,6 @@
         "editor.formatOnSave": true
     },
     "[javascript]": {
-        "editor.defaultFormatter": "biomejs.biome",
         "editor.codeActionsOnSave": {
             "source.organizeImports.biome": "explicit",
             "source.fixAll.biome": "explicit"

QUICKSTART.md

@@ -38,7 +38,14 @@ pnpm install
 pnpm dev:core
 ```
 
-Or run the script directly: `chmod +x scripts/start-dev.sh && ./scripts/start-dev.sh`
+Or run steps individually:
+
+```bash
+pnpm dev:core:docker
+pnpm dev:core:wait
+pnpm dev:core:migrate
+pnpm dev:core:apps
+```
 
 This will:
 

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

@@ -42,13 +42,20 @@ pnpm install
 pnpm dev:core
 ```
 
-Or run the script directly:
+Or run one step at a time:
 
 ```bash
-chmod +x scripts/start-dev.sh
-./scripts/start-dev.sh
+pnpm dev:core:docker
+pnpm dev:core:wait
+pnpm dev:core:migrate
+pnpm dev:core:apps
 ```
 
+- `dev:core:docker`: starts Postgres and Neo4j in Docker
+- `dev:core:wait`: waits for ports `5432` and `7687`
+- `dev:core:migrate`: runs registry + evault-core migrations
+- `dev:core:apps`: starts registry, evault-core, and dev-sandbox together
+
 This will:
 
 1. Start **Postgres** (port 5432) and **Neo4j** (7474, 7687) via `docker-compose.databases.yml`

package.json

@@ -10,19 +10,25 @@
         "check-format": "turbo run check-format",
         "check": "turbo run check",
         "check-types": "turbo run check-types",
-        "dev:core": "./scripts/start-dev.sh",
+        "dev:core": "pnpm dev:core:docker && pnpm dev:core:wait && pnpm dev:core:migrate && pnpm dev:core:apps",
+        "dev:core:docker": "pnpm docker:core",
+        "dev:core:wait": "pnpm exec wait-on tcp:127.0.0.1:5432 tcp:127.0.0.1:7687",
+        "dev:core:migrate": "pnpm --filter registry migration:run && pnpm --filter evault-core build && cross-env REGISTRY_DATABASE_URL= pnpm --filter evault-core migration:run",
+        "dev:core:apps": "pnpm exec concurrently -n registry,evault,sandbox \"pnpm --filter registry dev\" \"pnpm --filter evault-core dev\" \"pnpm --filter dev-sandbox dev\"",
         "docker:core": "docker compose -f docker-compose.databases.yml up -d",
         "docker:core:down": "docker compose -f docker-compose.databases.yml down"
     },
     "devDependencies": {
-        "concurrently": "^9.1.0",
         "@biomejs/biome": "^1.9.4",
         "@types/react": "18.3.27",
         "@types/react-dom": "18.3.7",
+        "concurrently": "^9.1.0",
+        "cross-env": "^7.0.3",
         "react": "18.3.1",
         "react-dom": "18.3.1",
         "turbo": "^2.4.4",
-        "typescript": "5.8.2"
+        "typescript": "5.8.2",
+        "wait-on": "^8.0.3"
     },
     "packageManager": "pnpm@10.25.0",
     "engines": {