# astro-theme-university > An Astro 7 theme package for university-style static sites, with progressively > enhanced native controls and no client-framework dependency. astro-theme-university provides layouts, components, and styles for building institutional websites. It ships neutral defaults (a teal primary colour, text wordmark navigation) and is re-branded by overriding a small set of CSS custom properties and passing branding data as props. It uses Astro's content collections, pure CSS with custom properties (no Tailwind), and optional astromotion integration for lecture slide decks. Key concepts: - **BaseLayout** wraps every page with navigation, footer, and theme support - **ContentLayout** extends BaseLayout with a title, optional hero image, and lead text - **Hero** and **Card** components accept imported images (`ImageMetadata`) for pipeline optimisation - all CSS custom properties use the `--at-` prefix; semantic tokens derive from the `--at-primary`/`--at-secondary`/`--at-tertiary` brand palette via relative colour syntax, so overriding the palette re-brands the whole theme - Light mode is the default; dark mode uses `[data-theme="dark"]` Every page below is also served as markdown at its HTML path plus `.md` (`https://anucybernetics.github.io/astro-theme-university/a/` → `https://anucybernetics.github.io/astro-theme-university/a/index.html.md`), linked from its head. [llms-full.txt](https://anucybernetics.github.io/astro-theme-university/llms-full.txt) has every page's text in one file (about 31k tokens; slide decks are left out). ## Pages - [Astromotion example deck](https://anucybernetics.github.io/astro-theme-university/decks/astromotion/): A showcase of slide features available in the theme's deck styles ## Docs - [Callout](https://anucybernetics.github.io/astro-theme-university/docs/components/callout/): Highlight important information with contextual callout boxes for tip, info, warning, and error messages. - [CardGrid](https://anucybernetics.github.io/astro-theme-university/docs/components/card-grid/): A responsive grid layout for arranging Card components in 2 or 3 column configurations. - [Card](https://anucybernetics.github.io/astro-theme-university/docs/components/card/): A versatile card component for displaying titled content blocks, optionally linked and with images. - [FilterableCardGrid](https://anucybernetics.github.io/astro-theme-university/docs/components/filterable-card-grid/): A card grid with a built-in searchbox for live filtering by title, description, tags, or badges. - [Footer](https://anucybernetics.github.io/astro-theme-university/docs/components/footer/): The site footer with contact details, social links, acknowledgement, legal links, partnership logos, and optional Creative Commons licensing. - [Hero](https://anucybernetics.github.io/astro-theme-university/docs/components/hero/): A full-width hero banner with a background image, overlaid title, and accent underline. - [Icon](https://anucybernetics.github.io/astro-theme-university/docs/components/icon/): Inline iconoir icons that inherit text colour and size from their context. - [Nav](https://anucybernetics.github.io/astro-theme-university/docs/components/nav/): The main site navigation bar with responsive mobile menu, search, and active link highlighting. - [Pagination](https://anucybernetics.github.io/astro-theme-university/docs/components/pagination/): Navigation controls for paginated content collections. - [Search](https://anucybernetics.github.io/astro-theme-university/docs/components/search/): Full-text site search powered by Pagefind, with a keyboard-driven dialog and automatic index building. - [Sidebar](https://anucybernetics.github.io/astro-theme-university/docs/components/sidebar/): Sticky sidebar navigation grouped into sections with active-link highlighting. - [YouTubeEmbed](https://anucybernetics.github.io/astro-theme-university/docs/components/youtube-embed/): A performant YouTube video embed using lite-youtube-embed, powered by astro-embed. - [Configuration](https://anucybernetics.github.io/astro-theme-university/docs/getting-started/configuration/): Configure theme options, create a site config file, and pass settings to the BaseLayout. - [Examples](https://anucybernetics.github.io/astro-theme-university/docs/getting-started/examples/): A starter example with the theme pre-configured --- copy it and start building. - [Installation](https://anucybernetics.github.io/astro-theme-university/docs/getting-started/installation/): Install astro-theme-university and its peer dependencies, configure the integration, and create your first page. - [Project setup](https://anucybernetics.github.io/astro-theme-university/docs/getting-started/project-setup/): Recommended directory structure, TypeScript configuration, tooling, and creating pages with the theme. - [Brand packages and course sites](https://anucybernetics.github.io/astro-theme-university/docs/guides/brand-packages/): Package an institution's identity as data the theme consumes, and add the course-site content model on top. - [Content collections](https://anucybernetics.github.io/astro-theme-university/docs/guides/content-collections/): Schema helpers the theme adds over Astro content collections. - [Deploying](https://anucybernetics.github.io/astro-theme-university/docs/guides/deploying/): Deploy an astro-theme-university site to common hosting platforms. - [Lecture decks](https://anucybernetics.github.io/astro-theme-university/docs/guides/lecture-decks/): Build Reveal.js slide decks with astromotion and compose them from reusable fragments with @include. - [Markdown extensions](https://anucybernetics.github.io/astro-theme-university/docs/guides/markdown-extensions/): Markdown and MDX features the theme adds: heading IDs, smart typography, callouts, and MDX expressions. - [Migrating from Jekyll](https://anucybernetics.github.io/astro-theme-university/docs/guides/migrating-from-jekyll/): Move a site from Jekyll to astro-theme-university. - [BaseLayout](https://anucybernetics.github.io/astro-theme-university/docs/layouts/base-layout/): The main page wrapper that provides navigation, footer, and theme support. - [ContentLayout](https://anucybernetics.github.io/astro-theme-university/docs/layouts/content-layout/): A convenience layout that wraps BaseLayout with a page title, optional description, and optional hero image. - [MdxPageLayout](https://anucybernetics.github.io/astro-theme-university/docs/layouts/mdx-page-layout/): The layout to hand to the integration's defaultLayout option --- frontmatter unwrapping, title joining, and the description-as-lead convention in one place. - [SidebarLayout](https://anucybernetics.github.io/astro-theme-university/docs/layouts/sidebar-layout/): A layout with an optional sidebar navigation and article column, built on top of BaseLayout. - [Buttons](https://anucybernetics.github.io/astro-theme-university/docs/styling/buttons/): Styled button classes for primary actions, with outline and ghost variants and size modifiers. - [CSS layers](https://anucybernetics.github.io/astro-theme-university/docs/styling/css-layers/): How the theme uses CSS cascade layers and how to work with them in your own styles. - [Customisation](https://anucybernetics.github.io/astro-theme-university/docs/styling/customisation/): How to re-brand the theme and override design tokens with your own styles. - [Dark mode](https://anucybernetics.github.io/astro-theme-university/docs/styling/dark-mode/): How the theme handles dark mode, including the toggle, persistence, and custom dark styles. - [Design tokens](https://anucybernetics.github.io/astro-theme-university/docs/styling/design-tokens/): CSS custom properties that control the theme's colours, typography, spacing, and layout. - [Forms](https://anucybernetics.github.io/astro-theme-university/docs/styling/forms/): Base styles for form elements including inputs, selects, textareas, checkboxes, and fieldsets.