> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aikeedo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Aikeedo themes

> What an Aikeedo theme controls, how the active theme is resolved and rendered, and when to use a theme instead of a plugin or a view override.

export const OfficialPlugins = ({skus}) => {
  const officialPlugins = {
    'chatbots': {
      name: 'Chatbots',
      icon: 'message-chatbot',
      description: 'Customers build AI chatbots trained on their content and embed them on their own websites.'
    },
    'migration': {
      name: 'Migration',
      icon: 'transfer-in',
      description: 'Imports conversation history from ChatGPT, Claude and Grok.'
    },
    'loops': {
      name: 'Loops',
      icon: 'mail',
      description: 'Syncs users to Loops as contacts, including a background bulk sync.'
    },
    'brevo': {
      name: 'Brevo',
      icon: 'mail',
      description: 'Syncs users to Brevo as contacts, including a background bulk sync.'
    },
    'mailchimp': {
      name: 'Mailchimp',
      icon: 'mail',
      description: 'Syncs users to a Mailchimp audience with tags and merge fields.'
    },
    'manual-tax': {
      name: 'Manual Tax Engine',
      icon: 'receipt-tax',
      description: 'Flat, country and state tax rates you define yourself.'
    },
    'stripe-tax': {
      name: 'Stripe Tax Engine',
      icon: 'brand-stripe',
      description: 'Calculates tax with Stripe Tax from the billing address.'
    },
    'cloud-storage': {
      name: 'Cloud Storage',
      icon: 'cloud',
      description: 'Stores files on AWS S3, Wasabi, DigitalOcean Spaces, Cloudflare R2 or MinIO.'
    },
    'paystack': {
      name: 'Paystack',
      icon: 'credit-card',
      description: 'Payments across Africa, with one-time checkout, recurring billing and trials.'
    },
    'razorpay': {
      name: 'Razorpay',
      icon: 'credit-card',
      description: 'Hosted checkout for one-time orders and subscriptions in India.'
    },
    'yookassa': {
      name: 'YooKassa',
      icon: 'credit-card',
      description: 'Payments in Russia, with VAT-ready receipts and recurring charges.'
    },
    'iyzico': {
      name: 'Iyzico',
      icon: 'credit-card',
      description: 'Embedded checkout for one-time and recurring payments in Turkey.'
    },
    'mercadopago': {
      name: 'Mercado Pago',
      icon: 'credit-card',
      description: 'Payments across Latin America, with subscriptions and trials.'
    },
    'xendit': {
      name: 'Xendit',
      icon: 'credit-card',
      description: 'Payment links and recurring plans for Indonesia, the Philippines and Southeast Asia.'
    },
    'cryptomus': {
      name: 'Cryptomus',
      icon: 'currency-bitcoin',
      description: 'Cryptocurrency payments for one-time purchases and subscriptions.'
    },
    'pulse': {
      name: 'Pulse Theme',
      icon: 'palette',
      description: 'A marketing theme with landing sections, pricing tables and dark mode.'
    }
  };
  return <CardGroup cols={skus.length === 1 ? 1 : 2}>
      {skus.map(sku => <Card key={sku} title={officialPlugins[sku].name} icon={officialPlugins[sku].icon} href={`https://aikeedo.com/marketplace/${sku}/`}>
          {officialPlugins[sku].description}
        </Card>)}
    </CardGroup>;
};

A theme is a Composer package that renders your public website. It owns the landing page, and it can add public pages of its own. Everything behind the login screen belongs to the application.

<Note>
  This page applies to Aikeedo 5.x. Class names, paths and signatures match the 5.0 source code.
</Note>

## What a theme controls

| Page                                    | Rendered by                                                   |
| --------------------------------------- | ------------------------------------------------------------- |
| Landing page, `/`                       | **Your theme**, from `templates/index.twig`                   |
| Extra public pages, such as `/features` | **Your theme**, if it registers routes through an entry class |
| Login, signup, password recovery        | Core templates                                                |
| Policy pages, such as `/policies/terms` | Core templates, with content from admin settings              |
| The app, `/app`, and the admin panel    | Core templates                                                |
| 404 and error pages                     | Core templates                                                |

<Note>
  To change a core template, use `resources/views/overrides/`, which isn't part of the theme system. See [Extending Aikeedo](/development/extending-aikeedo).
</Note>

## How rendering works

```mermaid theme={null}
flowchart TD
    A["GET /"] --> B{Landing page enabled?}
    B -- no --> C[Redirect to /app]
    B -- yes --> D[IndexRequestHandler]
    D --> E[Load active plans]
    E --> F["Render @theme/templates/index.twig"]
    F --> G[ViewMiddleware adds globals: option, user, currency, locale…]
    G --> H[HTML]
```

* The active theme is the package named by the `theme` option, which defaults to the bundled default theme. Publishing a theme in **Admin → Themes** sets it.
* `@theme` is a Twig namespace pointing at the active theme's directory, so every include in your templates starts with `@theme/`.
* The landing page receives `plans`, the active plans sorted by price. Every other global comes from the view middleware.
* `site.is_landing_page_enabled` turns the landing page off, which redirects `/` to the app.

## Preview before publishing

`/preview?theme=vendor/name` sets a short-lived preview cookie and sends you to the home page, so you can look at a theme without switching the live site.

## Anatomy

```text theme={null}
extra/extensions/acme/aurora/
├── composer.json          # type: aikeedo-theme
├── templates/
│   └── index.twig         # the landing page
├── layouts/
├── sections/
├── snippets/
├── assets/                # built CSS, JS and images
├── .vite/manifest.json    # written by the build
├── src/                   # optional PHP entry class and page handlers
└── locale/                # translation catalogs, theme domain
```

Only `composer.json` and `templates/index.twig` are required. Everything else is convention, plus whatever your build produces. See [The minimum theme](/development/themes/minimum-theme).

## Where themes come from

| Approach                                                                  | Use when                                                                                          |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| [The starter kit](/development/themes/quickstart)                         | You're building a new theme. It ships the build pipeline, a layout, custom elements and catalogs. |
| [Copy the default theme](/development/themes/customizing-existing-themes) | You want the shipped design with changes. Always rename it, or an update overwrites your work.    |
| From scratch                                                              | You want full control and no build step. Start from the minimum theme.                            |

Want a finished design instead of building one? The official Pulse theme is available on the [Aikeedo Marketplace](https://aikeedo.com/marketplace/):

<OfficialPlugins skus={['pulse']} />

## Theme development at a glance

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/development/themes/quickstart">
    Clone the starter kit and get hot reloading against a local installation.
  </Card>

  <Card title="Structure" icon="folders" href="/development/themes/structure">
    What every directory and file is for.
  </Card>

  <Card title="Template objects" icon="braces" href="/development/themes/template-objects">
    Every variable available in a theme template.
  </Card>

  <Card title="Custom pages" icon="file-plus" href="/development/themes/custom-pages">
    Add public pages with a PHP entry class.
  </Card>
</CardGroup>

## Need Help?

If you need assistance with Aikeedo:

<CardGroup cols={2}>
  <Card title="Professional Support" icon="headset" href="https://aikeedo.com/support/">
    Get expert help from our team with a paid support subscription
  </Card>

  <Card title="Troubleshooting Guide" icon="tool" href="/setup/troubleshooting">
    Check common issues and solutions
  </Card>
</CardGroup>