SFusion/README.md

SFusion (scaffold)

This repository is an initial Fusion-inspired RSS stack wired for PostgreSQL, a Vapor backend (Swift Package Manager executable Run), and a React + Vite frontend. Paths and JSON shapes intentionally match only where noted; full parity with 0x2e/fusion is still work in progress—see FUSION_REPOSITORY_ANALYSIS.md.

Quick start:

1. docker compose up --build (starts Postgres 18.0-trixie, backend image built from registry.kshaitry.com/library/swift:6.3, and the dev frontend container using node:22.21.1-alpine).

2. Open http://localhost:5173 — the page calls /api/health and /api/groups through the Vite proxy.

3. Read the step-by-step notes under doc/: doc/README.md. For everyday coding (Vite HMR, restarting Swift/Vapor), see doc/tutorial-development-live-reload.md. Ports are overridable via .env (see .env.example).

Kubernetes deployment manifests (Deployment, Service, StatefulSet, Ingress) live in k8s/ — see k8s/README.md and doc/step-08-kubernetes.md.