diff --git a/.env.example b/.env.example
index 4eba944..3327d2f 100644
--- a/.env.example
+++ b/.env.example
@@ -1,11 +1,12 @@
-# Configuration reference: http://docs.postiz.com/configuration/reference
+# Hanzo Social — env example. Upstream config reference: http://docs.postiz.com/configuration/reference
+# (upstream variable names are preserved; only defaults are rebranded)
# === Required Settings
-DATABASE_URL="postgresql://postiz-user:postiz-password@localhost:5432/postiz-db-local"
+DATABASE_URL="postgresql://hanzo-social:hanzo-social@localhost:5432/hanzo-social"
REDIS_URL="redis://localhost:6379"
JWT_SECRET="random string for your JWT secret, make it long"
-# === This needs to be exactly the URL you're accessing Postiz on
+# === This needs to be exactly the URL you're accessing Hanzo Social on
FRONTEND_URL="http://localhost:4200"
NEXT_PUBLIC_BACKEND_URL="http://localhost:3000"
BACKEND_INTERNAL_URL="http://localhost:3000"
diff --git a/CLAUDE.md b/CLAUDE.md
index 0526733..7dcb471 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,4 +1,4 @@
-This project is Postiz, a tool to schedule social media and chat posts to 28+ channels.
+This project is Hanzo Social (a hard fork of gitroomhq/postiz-app, AGPL-3.0), a tool to schedule social media and chat posts to 28+ channels. Deployed at https://social.hanzo.ai and integrated with Hanzo IAM (hanzo.id), Hanzo KMS, Hanzo S3, and ~/work/hanzo/bot. Upstream identifiers (env vars like `postiz-*`, package paths, internal symbols) are preserved verbatim; only user-facing brand surfaces are rebranded.
You can add posts to the calendar, they will be added into a workflow and posted at the right time.
You can find things like:
- Schedule posts
diff --git a/README.md b/README.md
index ab77670..d799111 100644
--- a/README.md
+++ b/README.md
@@ -1,148 +1,52 @@
-| Sponsor | Logo | Description |
-|---------|:-----------------------------------------------------------------------:|-----------------|
-| [Hostinger](https://www.hostinger.com/vps/docker/postiz?ref=postiz) | | Hostinger is on a mission to make online success possible for anyone – from developers to aspiring bloggers and business owners |
-| [Virlo](https://dev.virlo.ai/?ref=postiz) | | Virlo is the #1 social media trend spotting and all-in-one GTM tool for teams leveraging short-form video |
+---
+## What this is
+Hanzo Social is a hard fork of [`gitroomhq/postiz-app`](https://github.com/gitroomhq/postiz-app) (AGPL-3.0), rebranded and integrated with the Hanzo platform:
-# Intro
+- **Auth** — Hanzo IAM (`hanzo.id`) via OIDC (`IAM_CLIENT_ID=hanzo-social`).
+- **Storage** — Hanzo S3 (`s3-api.hanzo.ai`).
+- **Secrets** — Hanzo KMS (`kms.hanzo.ai`) via `kms-fetch` init container.
+- **Email** — `social@hanzo.ai` from the shared SMTP relay.
+- **Bot** — `~/work/hanzo/bot` exposes `/social {schedule|draft|integrations}` against this backend.
-- Schedule all your social media posts (many AI features)
-- Measure your work with analytics.
-- Collaborate with other team members to exchange or buy posts.
-- Invite your team members to collaborate, comment, and schedule posts.
-- At the moment there is no difference between the hosted version to the self-hosted version
-- Perfect for automation (API) with platforms like N8N, Make.com, Zapier, etc.
+Upstream remains the source of truth for the scheduling engine; brand and platform glue live in this repo.
-## Tech Stack
+## Develop
-- Pnpm workspaces (Monorepo)
-- NextJS (React)
-- NestJS
-- Prisma (Default to PostgreSQL)
-- Temporal
-- Resend (email notifications)
+```bash
+pnpm install
+pnpm dev
+```
-## Quick Start
-
-To have the project up and running, please follow the [Quick Start Guide](https://docs.postiz.com/quickstart)
-
-## Sponsor Postiz
-
-We now give a few options to Sponsor Postiz:
-- Just a donation: You like what we are building, and want to buy us some coffees so we can build faster.
-- Main Repository: Get your logo with a backlink from the main Postiz repository. Postiz has almost 3m downloads and 20k views per month.
-- Main Repository + Website: Get your logo on the central repository and the main website. Here are some metrics: - Website has 20k hits per month + 65 DR (strong backlink) - Repository has 20k hits per month + Almost 3m docker downloads.
-
-Link: https://opencollective.com/postiz
-
-## Postiz Compliance
-
-- Postiz is an open-source, self-hosted social media scheduling tool that supports platforms like X (formerly Twitter), Bluesky, Mastodon, Discord, and others.
-- Postiz hosted service uses official, platform-approved OAuth flows.
-- Postiz does not automate or scrape content from social media platforms.
-- Postiz does not collect, store, or proxy API keys or access tokens from users.
-- Postiz never ask users to paste API keys into our hosted product.
-- Postiz Users always authenticate directly with the social platform (e.g., X, Discord, etc.), ensuring platform compliance and data privacy.
-
-## Star History
-
-[](https://www.star-history.com/#gitroomhq/postiz-app&type=date&legend=top-left)
+See `CLAUDE.md` for repo layout and `apps/`, `libraries/` for the NestJS backend / Vite frontend / Temporal worker.
## License
-This repository's source code is available under the [AGPL-3.0 license](LICENSE).
-
-
-
-
-
-
-
-
-
\ No newline at end of file
+AGPL-3.0 — same as upstream. See `LICENSE`.
diff --git a/package.json b/package.json
index 498f56d..07f8844 100644
--- a/package.json
+++ b/package.json
@@ -1,11 +1,21 @@
{
- "name": "gitroom",
+ "name": "hanzo-social",
"version": "1.0.0",
- "description": "",
+ "description": "Hanzo Social — agentic social media scheduling. Forked from gitroomhq/postiz-app under AGPL-3.0.",
"main": "index.js",
"license": "AGPL-3.0",
- "keywords": [],
- "author": "",
+ "keywords": [
+ "hanzo",
+ "social",
+ "scheduling",
+ "agentic"
+ ],
+ "author": "Hanzo AI, Inc.",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/hanzoai/social.git"
+ },
+ "homepage": "https://social.hanzo.ai",
"engines": {
"node": ">=22.12.0 <23.0.0"
},
-
-
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
-
| Hostinger is on a mission to make online success possible for anyone – from developers to aspiring bloggers and business owners |
-| [Virlo](https://dev.virlo.ai/?ref=postiz) | 
-