# Compass > Compass is a free Astro documentation theme for product docs, help centers, and knowledge bases, with fast static search and MDX components. ## Getting Started: Start Here - [Set Up Compass](https://compass.xocoweb.workers.dev/getting-started/start-here/set-up-compass): Install Compass, run it locally, and make the first project-level updates. - [How Compass Is Organized](https://compass.xocoweb.workers.dev/getting-started/start-here/how-compass-is-organized): Understand how Compass is structured so you know where to customize content, navigation, and layout. - [Plan Your Editing Workflow](https://compass.xocoweb.workers.dev/getting-started/start-here/plan-your-editing-workflow): Set up a practical workflow for editing, reviewing, and publishing Compass docs. - [Create Your First Article](https://compass.xocoweb.workers.dev/getting-started/start-here/create-your-first-article): Add a new Compass article with the right folder structure, frontmatter, and optional images. - [Publish Compass](https://compass.xocoweb.workers.dev/getting-started/start-here/publish-compass): Prepare Compass for production, verify the build output, and publish with confidence. - [Rename and Restructure Categories](https://compass.xocoweb.workers.dev/getting-started/start-here/rename-and-restructure-categories): Adjust category labels, slugs, and grouping in Compass without losing track of how routes are generated. - [Add Your Brand](https://compass.xocoweb.workers.dev/getting-started/start-here/add-your-brand): Replace Compass defaults with your project's title, links, visuals, and overall identity. ## Getting Started: Compass Docs - [Write Your First Article](https://compass.xocoweb.workers.dev/getting-started/compass-docs/write-your-first-article): Create a real Compass article, connect it to a category, and see how it appears across the site. - [Manage Docs](https://compass.xocoweb.workers.dev/getting-started/compass-docs/manage-docs): Maintain collections, navigation order, and article publishing workflows. - [Customize Your Docs Site](https://compass.xocoweb.workers.dev/getting-started/compass-docs/customize-your-docs-site): Adjust branding, layout choices, and content presentation across your docs. - [Syntax Highlighting](https://compass.xocoweb.workers.dev/getting-started/compass-docs/syntax-highlighting): Add clean, readable code examples to your Compass docs with Astro's built-in syntax highlighting. - [How Navigation Works](https://compass.xocoweb.workers.dev/getting-started/compass-docs/how-navigation-works): Understand how Compass builds category pages, article links, and sidebar structure from your docs data. - [How Search Works](https://compass.xocoweb.workers.dev/getting-started/compass-docs/how-search-works): Understand how Compass uses Pagefind to generate scalable static search for your docs. - [Register MDX Components](https://compass.xocoweb.workers.dev/getting-started/compass-docs/register-mdx-components): Add new Astro components to Compass and make them available inside `.mdx` articles. - [Adding Images](https://compass.xocoweb.workers.dev/getting-started/compass-docs/adding-images): Keep article images next to their MDX files so Astro can optimize them and make them responsive. ## Getting Started: Components - [Callout Boxes](https://compass.xocoweb.workers.dev/getting-started/components/callout-boxes): Use compact callout boxes to highlight information, warnings, confirmations, and breaking changes. - [Section Headings](https://compass.xocoweb.workers.dev/getting-started/components/section-headings): Use H2, H3, and H4 headings to create a clear article structure without adding custom UI. - [Button Links](https://compass.xocoweb.workers.dev/getting-started/components/button-links): Use inline CTA buttons when an article should point readers to the next page or action. - [Quote Blocks](https://compass.xocoweb.workers.dev/getting-started/components/quote-blocks): Use quote blocks for editorial notes, testimonials, principles, and short perspective shifts. - [Local Icons](https://compass.xocoweb.workers.dev/getting-started/components/local-icons): Use the bundled Lucide icons, or add your own SVGs, without a runtime icon dependency. - [Accordions](https://compass.xocoweb.workers.dev/getting-started/components/accordions): Use accordions for FAQs, optional explanations, and advanced notes that should stay collapsed by default. - [Steps](https://compass.xocoweb.workers.dev/getting-started/components/steps): Use numbered steps when readers need to follow a process in a strict sequence. - [Checklists](https://compass.xocoweb.workers.dev/getting-started/components/checklists): Use interactive checklists when readers should be able to mark progress directly in the docs. - [Tabs](https://compass.xocoweb.workers.dev/getting-started/components/tabs): Use tabs when several variants share the same space, like platform-specific setup or alternative workflows. - [Code Tabs](https://compass.xocoweb.workers.dev/getting-started/components/code-tabs): Use code tabs for command variants, framework examples, and other code snippets that share the same step. - [File Tree](https://compass.xocoweb.workers.dev/getting-started/components/file-tree): Use file trees to explain project structure, article-owned assets, and where contributors should edit specific docs files. - [Badges](https://compass.xocoweb.workers.dev/getting-started/components/badges): Use small badges to mark statuses like new, beta, required, deprecated, or recommended. - [Tables](https://compass.xocoweb.workers.dev/getting-started/components/tables): Use styled tables for comparisons, feature matrices, and concise reference data inside docs articles. - [Card Grids](https://compass.xocoweb.workers.dev/getting-started/components/card-grids): Use link cards for next steps, related guides, and grouped destinations that deserve more presence than a plain text link. ## Integrations: Channels & Apps - [Integration Ideas for Compass](https://compass.xocoweb.workers.dev/integrations/channels-and-apps/integration-ideas-for-compass): A shortlist of practical integrations you can add as Compass grows beyond a simple MDX docs repo. - [Analytics](https://compass.xocoweb.workers.dev/integrations/channels-and-apps/analytics): Add analytics to Compass so you can understand what readers search, open, and return to. - [CMS Editing Workflows](https://compass.xocoweb.workers.dev/integrations/channels-and-apps/cms-editing-workflows): Plan an easier editing workflow if your team prefers a CMS or visual editor over raw MDX files. - [Embedded Help Panels](https://compass.xocoweb.workers.dev/integrations/channels-and-apps/embedded-help-panels): Add contextual help surfaces that link back to Compass articles without turning docs into a separate product. - [Chat Widget Links](https://compass.xocoweb.workers.dev/integrations/channels-and-apps/chat-widget-links): Connect support or onboarding chat surfaces back to Compass so answers stay linked to real documentation.