import { Link } from "react-router-dom"; import { Card, CardContent, CardDescription, CardHeader, CardTitle, } from "@/components/ui/card"; import { Badge } from "@/components/ui/badge"; import { Button } from "@/components/ui/button"; import { CheckCircle2, ArrowRight, PlugZap, Download, Rocket, Shield, Layers, Code, LayoutDashboard, IdCard, Users, ActivitySquare, } from "lucide-react"; const docCategories = [ { title: "Getting Started", description: "Quick start guides and tutorials for beginners", docs: 12, sections: ["Installation", "First Steps", "Basic Concepts", "Hello World"], color: "from-green-500 to-emerald-600", }, { title: "API Reference", description: "Complete API documentation with examples", docs: 45, sections: ["Authentication", "Endpoints", "SDKs", "Rate Limits"], color: "from-blue-500 to-cyan-600", }, { title: "Tutorials", description: "Step-by-step guides for common use cases", docs: 28, sections: ["Game Development", "Web Apps", "Mobile Apps", "AI Integration"], color: "from-purple-500 to-indigo-600", }, { title: "CLI Tools", description: "Command-line interface documentation", docs: 15, sections: ["Installation", "Commands", "Configuration", "Scripts"], color: "from-orange-500 to-red-600", }, ]; const prerequisites = [ { title: "AeThex Account", description: "You will need an active AeThex account to access the dashboard, API console, and deployment tools.", actionLabel: "Create account", actionHref: "/onboarding", }, { title: "Node.js 18+ & npm", description: "The AeThex CLI relies on modern Node runtimes. Verify your local toolchain before continuing.", actionLabel: "Verify environment", actionHref: "https://nodejs.org/en/download", }, { title: "Project Workspace", description: "Choose an empty directory for your new AeThex project or clone an existing team template.", actionLabel: "Browse templates", actionHref: "/projects/new", }, ]; const setupSteps = [ { title: "Install the CLI", description: "The CLI bootstraps local projects, provisions cloud environments, and manages deployments.", command: "npm install -g aethex", }, { title: "Authenticate", description: "Log in with your AeThex credentials or paste a personal access token from the dashboard.", command: "aethex login", }, { title: "Initialize a Project", description: "Scaffold configuration, environment files, and example services for your team.", command: "aethex init studio-hub", }, { title: "Start the Dev Server", description: "Run the local environment with hot reloading, mocked services, and seeded sample data.", command: "npm run dev", }, ]; const deploymentChecklist = [ { title: "Configure Environments", description: "Define staging and production targets, secrets, and automated health probes in aethex.config.ts.", }, { title: "Provision Resources", description: "Use `aethex deploy --preview` to create sandbox infrastructure before promoting to production.", }, { title: "Enable Safeguards", description: "Turn on role-based access controls, audit logging, and automated rollbacks from the dashboard.", }, ]; const platformHighlights = [ { title: "Unified dashboard", description: "Monitor deployments, review incidents, and share announcements with stakeholders from a single console.", icon: LayoutDashboard, }, { title: "Passport identity", description: "Give every builder a portable profile that aggregates achievements, verified skills, and mentorship history.", icon: IdCard, }, { title: "Community and mentorship", description: "Pair emerging studios with advisors, host showcase events, and recruit collaborators through the community hub.", icon: Users, }, { title: "Live ops analytics", description: "Track real-time KPIs, automate status updates, and route alerts into your team's notification channels.", icon: ActivitySquare, }, ]; const explorationLinks = [ { title: "Platform Walkthrough", description: "Tour the dashboard, notification center, and collaboration features.", href: "/dashboard", }, { title: "Platform documentation", description: "Share the high-level platform overview with non-technical teammates.", href: "/docs/platform", }, { title: "API Reference", description: "Review authentication flows, REST endpoints, and webhook schemas.", href: "/docs/api", }, { title: "Tutorial Library", description: "Follow guided builds for matchmaking services, player analytics, and live events.", href: "/docs/tutorials", }, { title: "Community Support", description: "Ask questions, share templates, and pair up with mentors in the public forums.", href: "/community", }, { title: "Integrations Playbook", description: "Review the HelloSkip embed and extend it to other partners.", href: "/docs/integrations", }, ]; export default function DocsGettingStarted() { return (
Getting Started

Launch your first AeThex project in under 30 minutes

This guide walks through the minimum setup required to ship a production-ready AeThex application. Complete the prerequisites, initialize a workspace with the CLI, and review the deployment checklist before inviting collaborators. Use the platform highlights below to brief product, community, and live-ops teams on everything available beyond deployment.

{/* NEW: Create an AeThex Account - Full step-by-step */}

Create an AeThex account (full)

Step 1 — Choose sign-in method AeThex supports Email/password, OAuth providers, and Web3 wallet sign-in.
  1. Email sign-up: go to{" "} /signup , provide your email and a secure password. A verification email will be sent — click the link to confirm.
  2. Google / GitHub: click the provider button on{" "} /login . The first time you sign in we'll create your account automatically using the provider email.
  3. Discord: use "Continue with Discord" on the login page. Existing accounts with the same email will be linked, otherwise a new account is created. For linking flows for existing staff, see the Dashboard → Connections.
  4. Web3 (optional): sign-in with Ethereum wallet via MetaMask — used only for wallet verification and account linking (no custody).
Step 2 — Verify & complete profile After initial login you'll be prompted to complete onboarding (profile, bio, primary arm).
  1. Check your email and follow the verification link (email provider flow).
  2. Complete the onboarding steps including name, bio, interests, and primary arm selection.
  3. Link any additional providers from{" "} Dashboard → Connections {" "} if needed.
  4. Once finished click "Finish & Go to Dashboard" to start using the platform.
Notes & troubleshooting
  • If an OAuth provider reports "account exists", sign in using the original provider and then link the new provider from Dashboard → Connections.
  • If you don't receive verification emails, check spam and ensure no company email filtering blocks support@aethex.tech.
  • Staff accounts (aethex.dev emails) may receive additional role access; contact HR if you expect staff access and it doesn't appear after login.

Documentation categories

Jump into the area you need most. Each category below is mirrored in Builder CMS for collaborative editing.

{docCategories.map((category) => (
{category.docs} docs
{category.title} {category.description}
    {category.sections.map((section) => (
  • {section}
  • ))}
))}
{prerequisites.map((item) => ( {item.title} {item.description} ))}

Onboarding — what to expect

Onboarding is a guided, multi-step flow that helps users complete the essential profile and platform setup. Typical onboarding steps:

  1. Personal Info — name, display handle, avatar.
  2. Profile Type — select experience level and role (creator, studio, enterprise).
  3. Interests & Skills — choose tags so we can recommend opportunities and mentors.
  4. Choose Primary Arm — pick the arm that best represents your work (Labs, GameForge, Corp, Foundation, Dev-Link).
  5. Creator Profile — optional portfolio, bio, links (recommended for discoverability).
  6. Finish — background tasks run (profile refresh) and you land on the dashboard.

You can always update these later from{" "} Profile → Settings .

Explore the platform

{platformHighlights.map((item) => { const Icon = item.icon; return ( {item.title} {item.description} ); })}

Setup workflow

{setupSteps.map((step, index) => ( Step {index + 1} {step.title} {step.description}
                  {step.command}
                
))}
{deploymentChecklist.map((item) => ( {item.title}

{item.description}

))}

Staff editing & governance

This public documentation is the platform-facing view. Internal operational documents remain private under{" "} /internal-docs.

Editors (staff) can edit public docs using Builder CMS. After changes are reviewed in Builder, create a GitHub PR to push finalized content into the repository so it can be deployed with site updates.

  • Edit in Builder:{" "} Open MCP popover {" "} and select Builder.io to edit live doc components and page content. (Staff only)
  • Publish workflow: Use the Builder preview to validate changes, then export or commit the markdown/content and open a GitHub PR for review. CI runs will deploy the updated public docs.
  • Security: Internal API references are intentionally not included in public docs. If you need to publish API guides for partners, request a gated partner docs area.

Next steps

{explorationLinks.map((link) => ( {link.title} {link.description} ))}
); }