Phoenix Sankofa Cloud

The sovereign cloud born of fire and ancestral wisdom.

Overview

Phoenix Sankofa Cloud is a next-generation, sovereign AI cloud infrastructure platform that combines:

• Mythic Power: Phoenix transformation and rebirth
• Ancestral Wisdom: Sankofa memory and return
• Cultural Identity: Akan heritage and sovereignty
• Global Reach: 325-region deployment
• Technical Excellence: World-class cloud infrastructure

Tech Stack

Frontend

• Next.js 14+ (React + TypeScript)
• TailwindCSS + shadcn/ui for styling
• Framer Motion for animations
• React Flow for graph editing
• react-three-fiber + drei for 3D visualizations
• ECharts for dashboards
• TanStack Query for data fetching

Backend (Planned)

• GraphQL API (Hasura/Postgres or Neo4j)
• WebSockets for real-time updates
• PostgreSQL for core data
• Neo4j (optional) for complex graph queries

Getting Started

Prerequisites

• Node.js 18+
• pnpm (recommended) or npm/yarn

Installation

# Install dependencies
pnpm install

# Run development server
pnpm dev

# Build for production
pnpm build

# Start production server
pnpm start

Development

# Type checking
pnpm type-check

# Linting
pnpm lint

# Formatting
pnpm format

# Testing
pnpm test
pnpm test:coverage

Environment Variables

Create a .env.local file in the root directory with the following variables:

# GraphQL API
NEXT_PUBLIC_GRAPHQL_ENDPOINT=/api/graphql

# Application
NEXT_PUBLIC_APP_URL=http://localhost:3000
NODE_ENV=development

# Monitoring (optional)
NEXT_PUBLIC_SENTRY_DSN=
SENTRY_AUTH_TOKEN=

# Analytics (optional)
NEXT_PUBLIC_ANALYTICS_ID=

See the portal README for portal-specific environment variables.

Project Structure

Sankofa/
├── docs/                    # Documentation
│   ├── brand/              # Brand documentation
│   └── architecture/        # Technical architecture
├── src/
│   ├── app/                # Next.js app router pages
│   ├── components/         # React components
│   │   ├── ui/            # UI components (shadcn/ui)
│   │   ├── 3d/            # 3D visualization components
│   │   ├── dashboards/    # Dashboard components
│   │   ├── editors/       # Graph/flow editors
│   │   └── well-architected/ # WAF components
│   ├── lib/               # Utilities and helpers
│   ├── styles/           # Global styles
│   └── content/          # Content files
├── public/               # Static assets
│   └── brand/           # Brand assets
└── package.json

Brand Philosophy

Phoenix Sankofa Cloud is built on the principle of Remember → Retrieve → Restore → Rise:

• Remember: Where we came from
• Retrieve: What was essential
• Restore: Identity and sovereignty
• Rise: Forward with purpose

Documentation

See the /docs directory for:

• Brand philosophy and positioning
• Product naming system
• Technical architecture
• Well-Architected Framework approach

License

[To be determined]

---

Phoenix Sankofa Cloud — Remember. Retrieve. Restore. Rise.