Integrations

Lotus includes integrations for icons, syntax highlighting, image galleries, and package-manager command tabs.

Iconify

Lotus installs the @prosefly/astro-components/icon integration internally. It preloads icons used by Lotus, icons used by Prosefly components, theme config icons, and static <Icon name="..."> usage in Astro and MDX files.

iconify: {
  apiBase: 'https://api.iconify.design',
  preload: ['lucide:sparkles'],
  scan: true,
}

Use preload for icons that cannot be detected statically.

Set scan: false when a project wants only explicit preload names.

Expressive Code

Expressive Code is enabled by default.

expressiveCode: {
  defaultProps: {
    showLineNumbers: false,
  },
}

Lotus configures light and dark Shiki themes, line numbers, copy button styling, and code frame styling to match the theme tokens.

Disable Expressive Code when a project should use Astro’s built-in Shiki renderer.

expressiveCode: false

Package Manager Tabs

Lotus enables the Prosefly package-manager tabs remark plugin by default. It turns recognized install commands into tabbed command blocks.

packageManagerTabs: false

Set packageManagerTabs to false to keep package-manager commands as normal code blocks.

Image Galleries

Lotus also installs the Prosefly image gallery rehype plugin. Paragraphs that contain only Markdown images are transformed into responsive gallery figures.

See Images for authoring details.

Component Overrides

Use components to replace selected Lotus theme components. See Overriding Components for the complete override surface and examples.