Atra

Cognitive laboratory website for system dynamics, strategic foresight, and structural redesign.

Stack: TypeScript (React + Vite) frontend · Go (Chi) API

Quick start

1. API (Go)

cd server
go run ./cmd/atra

API listens on http://localhost:8080.

2. Frontend (TypeScript)

cd web
npm install
npm run dev

App runs on http://localhost:5174 and proxies /api to the Go server.

Production (Go serves API + static)

cd web && npm run build
cd ../server && ATRA_STATIC=../web/dist go run ./cmd/atra

Then open http://localhost:8080.

GitHub Pages

Push to main deploys the Vite build via Actions to:

https://ali-m07.github.io/atra/

Pages serves static files only. Content is exported from the Go package into web/public/content/ at build time (VITE_STATIC=true). The live Go API is not required for the Pages site. To point the frontend at a hosted API later, set VITE_API_URL in the workflow.

ArvanCloud Object Storage

Each push to main also runs .github/workflows/deploy-arvan-storage.yml, which builds the site and syncs web/dist/ to Arvan Object Storage. GitHub Pages and Arvan deploy independently; a failure in one does not block the other.

For manual deploy from Windows (e.g. during internet outages), see OFFLINE-DEPLOY.md or run:

make deploy-arvan

Configure these in GitHub Repository settings:

Type	Name	Value
Secret	ARVAN_ACCESS_KEY	Access Key فضای ابری
Secret	ARVAN_SECRET_KEY	Secret Key فضای ابری
Variable	ARVAN_BUCKET	e.g. atra-site
Variable	ARVAN_S3_ENDPOINT	https://s3.ir-thr-at1.arvanstorage.ir

Until ARVAN_BUCKET is set, the Arvan upload steps are skipped safely.

API

Endpoint	Description
GET /api/health	Health check
GET /api/meta	Brand, pillars, manifesto
GET /api/pages/philosophy	Philosophy & identity
GET /api/pages/methodology	Research framework
GET /api/pages/whitepaper	Architecture of Reality whitepaper

Languages

English and Persian (فارسی), with RTL support.

• Switcher: EN | فا in the header (preference saved in localStorage)

• API: GET /api/meta?lang=fa · GET /api/pages/philosophy?lang=fa

• / — Hero, ecosystem, manifesto

• /philosophy — Who we are & core philosophy

• /methodology — Structural research framework

• /whitepaper — Methodology whitepaper

@atra_futures