Next.js web application for Lumina Network, providing a dashboard for managing vesting vaults, participating in veto-based governance proposals, and tracking token streams.
- Vesting Vault Dashboard: Interactive interface to view, track, and manage active vesting schedules and token streams.
- Governance Portal: Real-time veto voting interface allowing beneficiaries to challenge and vote on admin-proposed governance actions.
- Analytics & Compliance: Visual progress tracking, claim history analytics, and integrated KYC/AML compliance workflows.
- Language/Framework: Next.js (React) / TypeScript
- Styling: Tailwind CSS
- Package Manager: pnpm (via Corepack)
This application includes client-side field-level encryption for sensitive payloads such as node configuration secrets.
- Encrypts sensitive fields before persistence or outbound transport.
- Uses PBKDF2-derived AES-GCM keys with deterministic root salt for session reuse.
- Supports schema-driven encryption and decryption across nested payload structures.
- Designed so plaintext secrets are purged from application state immediately after encryption.
See ENCRYPTION_ARCHITECTURE.md for detailed design notes and implementation guidance.
The app audits live service configuration against versioned baselines, detects drift, and supports blue-green / canary promotion gates.
- Critical-path audits target <100ms P99.
- Drift findings are redacted before telemetry and dashboard display.
- Operator dashboard:
/dashboard/config-audit.
See CONFIG_AUDIT_ARCHITECTURE.md and CONFIG_AUDIT_RUNBOOK.md.
Staging chaos experiments are validated before blue-green or canary promotion.
- Critical user paths must remain below <100ms P99.
- Staging availability must stay at or above 99.99%.
- Experiments require security review, blast-radius controls, monitoring, and rollback ownership.
See CHAOS_ENGINEERING_BLUEPRINT.md and src/lib/chaos/policy.ts.
- Node.js 22 or higher
- pnpm (Corepack recommended)
git clone https://github.com/ZuLu0890/Lumina-Frontend.git
cd Lumina-Frontend
corepack enable
pnpm run onboardRun the onboarding helper to validate your Node.js version, create local environment files, install dependencies with the detected package manager, and run TypeScript checks:
pnpm run onboardFor CI or pre-flight validation without installing dependencies, run:
pnpm run onboard:checkThe script creates .env.local from .env.example when needed and verifies the required NEXT_PUBLIC_* configuration keys for local development.
pnpm run devpnpm run buildContributions are welcome. Please keep changes focused, verify the production build before opening a pull request, and open an issue first for major structural changes.
Runtime configuration is audited through schema validation, baseline drift detection, hot-reload safety checks, and canary promotion gates. See the configuration architecture and configuration runbook for rollout and incident-response details.