Merge branch 'getting-started-updates' into 'develop'

Update stale "Getting Started" sections in README

See merge request polycentric/polycentric!527

Author: markharding

README.md

@@ -15,15 +15,39 @@
 
 > :warning: **We're working on this.**
 
-You will need [just](https://github.com/casey/just), Docker, and pnpm.
+You will need:
 
-1. **Build rs-core for all platforms:** `just packages/rs-core/build-all`
-2. **Install dependencies:** `pnpm install`
-3. **Run the app:** `pnpm:run web`, `pnpm run:ios`, or `pnpm run:android`
+- [Node.js](https://nodejs.org), version pinned in `.nvmrc`
+- [pnpm](https://pnpm.io)
+- [Rust toolchain](https://rustup.rs)
+- [`protoc`](https://github.com/protocolbuffers/protobuf)
+- [`docker compose`](https://github.com/docker/compose)
 
-## Development
+The following commands will get you up and running:
+```sh
+# Use node version manager to install the pinned version of node
+nvm install
 
-- `pnpm dev` builds all SDKs in watch mode.
+# Add the WASM target to the rust toolchain
+rustup target add wasm32-unknown-unknown
+
+# Build the frontend and core binaries
+pnpm install
+pnpm build
+
+# Start the server process
+docker compose up -d --build
+
+# Apply the database schema if it has changed
+docker compose run --rm server /app/migration fresh
+
+# Start the frontend dev server
+pnpm dev
+```
+
+If you're using Podman, ensure `docker compose` resolves to Compose v2.
+
+To run the server from source instead, see [`services/server/README.md`](services/server/README.md).
 
 ## Project Structure
 
@@ -34,10 +58,11 @@ You will need [just](https://github.com/casey/just), Docker, and pnpm.
 | `packages/js-core` | Core JavaScript library containing the main Polycentric protocol logic |
 | `packages/js-browser` | Browser SDK using SQLite WASM for local storage |
 | `packages/js-node` | Node.js SDK using sqlite3 for local storage |
+| `packages/js-storage-sqlite` | Shared SQLite (Drizzle ORM) storage layer for the JS SDKs |
 | `packages/react-native` | React Native SDK for mobile applications |
+| `packages/rs-common` | Shared Rust code used by rs-core |
 | `packages/rs-core` | Rust core library - the underlying protocol implementation |
-| `packages/rs-core-wasm-browser` | Rust core compiled to WebAssembly for browser environments |
-| `packages/rs-core-wasm-node` | Rust core compiled to WebAssembly for Node.js environments |
+| `packages/rs-core-uniffi-web` | rs-core on WASM with `uniffi-bindgen-react-native` bindings |
 
 ### Apps
 

compose.yml

@@ -41,6 +41,10 @@ services:
     ports:
       - 9000:9000
       - 9001:9001
+    environment:
+      # rustfs:latest refuses the default root credentials on a non-loopback listener. This
+      # re-enables them so that default credentials continue to work for all dependent services.
+      - RUSTFS_ALLOW_INSECURE_DEFAULT_CREDENTIALS=true
     healthcheck:
       test: ['CMD', 'curl', '-sf', 'http://localhost:9000/health']
       interval: 10s

packages/rs-core/README.md

@@ -1,11 +1,6 @@
 # Polycentric Core Rs
 
-Rust core library for the Polycentric protocol. Compiles to static libraries (FFI) for iOS/Android and to WASM for web/node.
+Rust core library for the Polycentric protocol. Compiled to native FFI bindings (iOS/Android) and WASM (web) via uniffi-bindgen-react-native (`ubrn`).
 
-From this directory, use the justfile for builds, tests, and tooling:
-
-- `just build-all` — FFI (iOS sim + Android) + WASM for web and node; deploys into react-native
-- `just build-all-device` — same but iOS device (not sim)
-- `just build-ffi-ios-sim`, `just build-ffi-android-all`, `just build-wasm-all` — individual targets
-- `just test`, `just check`, `just format`, `just clippy`, `just doc` — cargo workflows
-- `just` — list all recipes
+Builds are usually driven from the root `pnpm` workspace, but `cargo` or `just` can be used in this
+directory to run workflows specific to `just`. Use `just` in the terminal to list the recipes.