web

PrivateDAO Web

This app is the Next.js surface for PrivateDAO.

It now powers the published root surface, while docs/ remains available as the archive and raw-reference surface for reviewer packets and deep links that still point there.

Scope

The goal is not a generic DAO dashboard. This app needs to preserve the real product story already present in the repository:

• private governance on Solana
• proposal lifecycle: create -> commit -> reveal -> execute
• additive hardening paths including V3 governance and settlement
• ZK, REFHE, MagicBlock, and Fast RPC surfaces
• buyer-facing service and pilot surfaces

Current Routes

• / overview and product landing page
• /command-center guided buyer / operator / reviewer workflow
• /dashboard governance dashboard shell
• /analytics analytics and treasury activity views
• /proof reviewer and proof surface
• /documents curated in-app document library for reviewer and trust docs
• /security additive hardening and launch boundary surface
• /diagnostics runtime, readiness, and verification surface
• /services commercial comparison and pilot surface
• /awards recognition and credibility surface

Local Development

Run from the repo root:

npm run web:dev

Or directly:

cd apps/web
npm run dev

Static Export Modes

This app is now configured for static export and already serves as the canonical published surface at the repo root.

From the repo root:

npm run web:build
npm run web:build:github
npm run web:build:root

Meaning:

• web:build uses the default environment and current base-path assumptions
• web:build:github builds for https://x-pact.github.io/PrivateDAO/
• web:build:root builds for a root domain such as https://PrivateDAO.xyz/

The app uses NEXT_PUBLIC_BASE_PATH and NEXT_PUBLIC_LIVE_SITE_URL to keep routes, assets, metadata, and reviewer links consistent across both deployment targets.

Mirror and live-surface helpers from the repo root:

npm run web:bundle:github
npm run web:bundle:root
npm run web:verify:bundle:github
npm run web:verify:bundle:root
npm run web:publish:github
npm run web:verify:live:github
npm run build:web-next-handoff
npm run verify:web-next-handoff

These produce export-ready directories and archives under dist/.

Route parity reference:

• docs/web-next-route-parity.md
• docs/web-next-handoff.generated.md
• docs/web-next-cutover-map.generated.md
• docs/web-next-query-strategy.generated.md
• docs/web-next-doc-viewer-plan.generated.md

Live Publishing Rule

The published root surface now comes from the apps/web static export.

The docs/ directory remains in the repository and remains useful for:

• archive/reference access
• raw markdown review
• historical deep links
• reviewer cross-checking during mirror and .xyz rollout