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

    Unified dashboard

    Platform

    Monitor deployments, live metrics, and release health from a single control surface. Jump into incidents, approvals, and audit trails without leaving the workspace.

    Visit dashboard

    AeThex Passport

    Platform

    Give builders portable identity with verified skills, achievements, and cross-product progress synced to their Passport profile.

    Open passport

    Collaboration

    Platform

    Coordinate teams with realms, role-based access, and shared project templates. Invite talent directly from the community directory.

    Meet the community

    Live operations

    Platform

    Run live experiences with analytics, status pages, and automated incident workflows wired into AeThex services.

    Check status

    Collaboration workflows

    Step 1

    Onboard & align

    Welcome teammates through the guided onboarding flow, capture their interests, and assign the right mentorship programs from day one.

    Onboarding modules cover personal info, interests, and project preferences so teams ramp quickly.

    Step 2

    Build together

    Kick off projects with shared canvases, synced task boards, and CLI-generated environments. Use the realm switcher to target the correct workspace.

    In-app toasts notify collaborators when schema changes, deployments, or reviews need attention.

    Step 3

    Launch & iterate

    Promote builds through AeThex Deploy, track KPIs in the analytics feed, and publish release notes via the changelog tools.

    Community announcements and blog posts keep players and stakeholders in the loop automatically.

    Experience modules

    Social feed
    Platform

    Share updates, prototypes, and patch notes in the feed. The composer supports media, Markdown, and rollout tags for targeted audiences.

    Learn more

    Mentorship programs
    Platform

    Match emerging studios with veteran advisors. Outline project goals, track sessions, and graduate mentors into full collaborators.

    Learn more

    Community showcases
    Platform

    Highlight standout creators, publish case studies, and route interested partners to booking forms right from the community page.

    Learn more

    Profile passport
    Platform

    Curate public achievements, experience levels, and verified skill badges. Use the passport summary widget across marketing surfaces.

    Learn more

    Insights & analytics

    Realtime insights

    Project metrics stream into dashboards with per-environment filters. Combine ingestion data with custom signals exposed via the REST API.

    Governed data

    Role-aware views ensure sensitive dashboards only appear for authorized users. Export snapshots or schedule recurring digests.

    Operational history

    Every deployment, incident, and advisory event lands in the shared timeline so teams can audit changes months later.

    Governance checklist

    • 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.

    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.

    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.

    Review builder flowManage identityStart from templateMonitor ops