import { Card, CardContent, CardDescription, CardHeader, CardTitle, } from "@/components/ui/card"; import { Badge } from "@/components/ui/badge"; import { Button } from "@/components/ui/button"; import { LayoutDashboard, IdCard, Users, ActivitySquare, Sparkles, Compass, Workflow, ShieldCheck, Database, BarChart3, Globe, ArrowRight, Link as LinkIcon, } from "lucide-react"; import { Link } from "react-router-dom"; const platformPillars = [ { title: "Unified dashboard", description: "Monitor deployments, live metrics, and release health from a single control surface. Jump into incidents, approvals, and audit trails without leaving the workspace.", icon: LayoutDashboard, href: "/dashboard", cta: "Visit dashboard", }, { title: "AeThex Passport", description: "Give builders portable identity with verified skills, achievements, and cross-product progress synced to their Passport profile.", icon: IdCard, href: "/passport/me", cta: "Open passport", }, { title: "Collaboration", description: "Coordinate teams with realms, role-based access, and shared project templates. Invite talent directly from the community directory.", icon: Users, href: "/community", cta: "Meet the community", }, { title: "Live operations", description: "Run live experiences with analytics, status pages, and automated incident workflows wired into AeThex services.", icon: ActivitySquare, href: "/status", cta: "Check status", }, ]; const collaborationWorkflows = [ { label: "Onboard & align", description: "Welcome teammates through the guided onboarding flow, capture their interests, and assign the right mentorship programs from day one.", highlight: "Onboarding modules cover personal info, interests, and project preferences so teams ramp quickly.", }, { label: "Build together", description: "Kick off projects with shared canvases, synced task boards, and CLI-generated environments. Use the realm switcher to target the correct workspace.", highlight: "In-app toasts notify collaborators when schema changes, deployments, or reviews need attention.", }, { label: "Launch & iterate", description: "Promote builds through AeThex Deploy, track KPIs in the analytics feed, and publish release notes via the changelog tools.", highlight: "Community announcements and blog posts keep players and stakeholders in the loop automatically.", }, ]; const experienceModules = [ { name: "Social feed", description: "Share updates, prototypes, and patch notes in the feed. The composer supports media, Markdown, and rollout tags for targeted audiences.", href: "/feed", }, { name: "Mentorship programs", description: "Match emerging studios with veteran advisors. Outline project goals, track sessions, and graduate mentors into full collaborators.", href: "/mentorship", }, { name: "Community showcases", description: "Highlight standout creators, publish case studies, and route interested partners to booking forms right from the community page.", href: "/community", }, { name: "Profile passport", description: "Curate public achievements, experience levels, and verified skill badges. Use the passport summary widget across marketing surfaces.", href: "/profile", }, ]; const analyticsHighlights = [ { title: "Realtime insights", detail: "Project metrics stream into dashboards with per-environment filters. Combine ingestion data with custom signals exposed via the REST API.", icon: BarChart3, }, { title: "Governed data", detail: "Role-aware views ensure sensitive dashboards only appear for authorized users. Export snapshots or schedule recurring digests.", icon: ShieldCheck, }, { title: "Operational history", detail: "Every deployment, incident, and advisory event lands in the shared timeline so teams can audit changes months later.", icon: Database, }, ]; const governanceChecklist = [ "OAuth connections let studios link third-party identity providers for single sign-on and group provisioning.", "Realm switcher enforces scoped access to projects, assets, and financial data.", "Compliance exports bundle audit logs, access reviews, and deployment manifests for regulatory submissions.", "Automated alerts surface risk when environments drift or policy checks fail during deploys.", ]; const resourceLinks = [ { title: "Explore onboarding", href: "/onboarding", label: "Review builder flow", }, { title: "Configure OAuth", href: "/docs/api#authentication", label: "Manage identity", }, { title: "Launch new project", href: "/projects/new", label: "Start from template", }, { title: "Track live status", href: "/status", label: "Monitor ops", }, ]; export default function DocsPlatform() { return (
Platform Experience

Deliver cohesive player and builder journeys on AeThex

Beyond deployment pipelines and CLI tooling, AeThex bundles collaboration, identity, and live-ops systems so teams can craft unforgettable experiences. Use this guide to orient new stakeholders and plan end-to-end platform rollouts.

Core pillars

{platformPillars.map((pillar) => { const Icon = pillar.icon; return (
{pillar.title}
Platform
{pillar.description}
); })}

Collaboration workflows

{collaborationWorkflows.map((stage, index) => ( Step {index + 1} {stage.label} {stage.description}

{stage.highlight}

))}

Experience modules

{experienceModules.map((module) => ( {module.name} Platform {module.description} ))}

Insights & analytics

{analyticsHighlights.map((item) => { const Icon = item.icon; return (
{item.title}
{item.detail}
); })}

Governance checklist

    {governanceChecklist.map((item) => (
  • {item}
  • ))}
{/* Architecture */}

Architecture overview

AeThex is composed of a lightweight React + Vite frontend, a Node.js backend that exposes API endpoints (under{" "} /api/*), and a Supabase-backed PostgreSQL database. The system integrates several services:

  • Frontend: React + TypeScript, Docs and Internal hubs use a separate layout and access control.
  • Backend: Node/Express handlers for public APIs, Discord webhooks, and OAuth flows.
  • Database: Supabase (Postgres) stores user profiles, creator data, and operational tables. Migrations live under code/supabase/migrations.
  • Integrations: OAuth providers (Google, GitHub, Discord, Roblox), Discord bot for role mapping & verification, and optional Web3 wallet linking.
  • Docs & CMS: Public docs are rendered with DocsLayout and editable in Builder CMS (MCP). Internal docs live under /internal-docs and require authentication.

This arrangement lets staff operate private operational processes while exposing curated platform docs publicly.

{/* Troubleshooting */}

Common troubleshooting

OAuth redirect issues

If an OAuth provider returns an invalid_redirect_uri{" "} error, verify that the callback URL configured in the provider matches the deployed app's API base (e.g.{" "} https://aethex.dev/api/discord/oauth/callback for Discord). For local development use the configured VITE_API_BASE when available.

Session/linking problems

If a linking flow (e.g. linking Discord) redirects to login or loses session, check cookie SameSite settings and ensure the redirect URI domain matches where cookies are set. Staff can consult internal docs under /internal-docs/onboarding{" "} for detailed diagnostic steps.

Missing emails

Verification and notification emails are sent from{" "} support@aethex.tech. If emails are not arriving, check spam filters and outbound SMTP logs (Hostinger) for delivery failures.

Keep exploring the platform

Share this page with non-technical teammates. It links out to every major surface area so marketing, product, and operations groups can navigate confidently.

{resourceLinks.map((resource) => ( ))}
); }