# Recipes

Complete common Lotus tasks without reading every reference page first.

import { Card, CardGrid, Callout } from '@prosefly/astro-components';

Recipes are task-oriented guides. Use them when you know what you want to build
and need the shortest safe path through configuration, content, and
customization.

<Callout type="note" title="Recipes are not API references">
  Use recipes for end-to-end tasks that cross multiple settings or files. Use
  [Configuration Reference](/docs/references/configuration/) when you need every
  option, default value, or single-field detail.
</Callout>

## Structure And Routing

<CardGrid>
  <Card icon="lucide:folder-tree" title="Project structure" href="/docs/recipes/project-structure/">
    Start from a recommended file layout for content, config, assets, and local
    overrides.
  </Card>
</CardGrid>

## Overrides

<CardGrid>
  <Card icon="lucide:sun-moon" title="Theme switch variants" href="/docs/recipes/theme-switch-variants/">
    Replace the default theme mode control with a button, select, segmented
    control, or light/dark switch.
  </Card>
  <Card icon="lucide:replace" title="Override shell components" href="/docs/recipes/override-shell-components/">
    Replace shell slots while reusing public theme components where appropriate.
  </Card>
</CardGrid>

## Related References

<CardGrid>
  <Card icon="lucide:route" title="Content routing" href="/docs/configuration/content-routing/">
    Configure `docsBase`, Markdown routes, search indexes, and slug overrides.
  </Card>
  <Card icon="lucide:globe-2" title="Internationalization" href="/docs/configuration/i18n/">
    Configure locale directories, localized routes, fallbacks, and UI strings.
  </Card>
  <Card icon="lucide:search" title="Search" href="/docs/configuration/search/">
    Choose the local provider, Pagefind, DocSearch, or disable search.
  </Card>
  <Card icon="lucide:map" title="Navigation" href="/docs/configuration/navbar/">
    Configure navbar links, social links, sidebars, and footer sections.
  </Card>
  <Card icon="lucide:git-pull-request" title="Source and edit links" href="/docs/configuration/source/#edit-links">
    Configure hosted repository metadata, edit links, and contributors.
  </Card>
  <Card icon="lucide:upload-cloud" title="Deployment" href="/docs/deployment/">
    Build Lotus and publish the generated static output.
  </Card>
</CardGrid>