First Commit

README.md

@@ -0,0 +1,24 @@
+# GreenCoast — Privacy-First, Shardable Social (Dockerized)
+
+**Goal:** A BlueSky-like experience with **shards**, **zero-trust**, **no data collection**, **E2EE**, and easy self-hosting — from x86_64 down to **Raspberry Pi Zero**.  
+License: **The Unlicense** (public-domain equivalent).
+
+This repo contains a minimal, working **shard**: an append-only object API with zero-data-collection defaults. It’s structured to evolve into full federation, E2EE, and client apps, while keeping Pi Zero as a supported host.
+
+---
+
+## Quick Start (Laptop / Dev)
+
+**Requirements:** Docker + Compose v2
+
+```bash
+git clone <your repo> greencoast
+cd greencoast
+cp .env.example .env
+docker compose -f docker-compose.dev.yml up --build
+# Health:
+curl -s http://localhost:8080/healthz
+# Put an object (dev mode allows unauthenticated PUT/GET):
+curl -s -X PUT --data-binary @README.md http://localhost:8080/v1/object
+# -> {"ok":true,"hash":"<sha256>",...}
+curl -s http://localhost:8080/v1/object/<sha256> | head