# Thulite Docs

> Congrats on setting up a new Doks project!

- [Page not found](https://docs.thulite.io/404/): This page appears when a requested URL cannot be found, and helps visitors recover quickly by returning to navigation or the homepage.
- [Start Here](https://docs.thulite.io/start-here/): Start with Thulite through a guided path covering installation, configuration, daily usage, verification, updates, and troubleshooting.
- [Basics](https://docs.thulite.io/basics/): Learn Thulite basics, from content and layouts to assets, integrations, templates, and deployment, so you can build and ship sites confidently.
- [Advanced](https://docs.thulite.io/advanced/): Explore advanced Thulite topics for performance, security, SEO, analytics, CMS integration, and multilingual sites to improve production readiness.
- [Reference](https://docs.thulite.io/reference/): Use this reference section to quickly find authoritative details on Thulite CLI, commands, configuration fields, and Markdown syntax behavior.

## Start Here

> Start with Thulite through a guided path covering installation, configuration, daily usage, verification, updates, and troubleshooting.

- [Getting Started](https://docs.thulite.io/start-here/getting-started/): Get oriented with Thulite's core goals, required prerequisites, and the next documentation steps to install, configure, use, and maintain your site.
- [Installation](https://docs.thulite.io/start-here/installation/): Create a new Thulite project with the CLI, choose a template and variant, and bootstrap a ready-to-run site with optional integrations.
- [Configuration](https://docs.thulite.io/start-here/configuration/): Configure Thulite by updating Hugo settings, project parameters, and page frontmatter, then apply integration-specific options when needed.
- [Usage](https://docs.thulite.io/start-here/usage/): Follow the day-to-day Thulite workflow to create content, run the dev server, format files, build production output, and preview locally.
- [Verification](https://docs.thulite.io/start-here/verification/): Verify your Thulite build by checking generated HTML, assets, metadata, and runtime behavior before deployment with browser and audit tools.
- [Updating](https://docs.thulite.io/start-here/updating/): Navigate Thulite update guidance, including release tracking, semantic versioning, and upgrade paths for keeping projects current and stable.
- [Troubleshooting](https://docs.thulite.io/start-here/troubleshooting/): Troubleshoot common Thulite issues by validating configuration, checking integration docs, and using GitHub issues and discussions for support.
- [Editor Setup](https://docs.thulite.io/start-here/editor-setup/): Set up your editor for Thulite with recommended VS Code extensions and formatting commands to keep Markdown, styles, and scripts consistent.
- [Concepts](https://docs.thulite.io/start-here/concepts/): Explore core Thulite concepts that explain framework decisions, including architecture principles, dependency strategy, and project fundamentals.

### Updating

> Navigate Thulite update guidance, including release tracking, semantic versioning, and upgrade paths for keeping projects current and stable.

- [Updating Overview](https://docs.thulite.io/start-here/updating/overview/): Learn how to update Thulite, track release changes, and use semantic versioning to plan safe upgrades across patch, minor, and major releases.
- [V2](https://docs.thulite.io/start-here/updating/v2/): Migrate from Thulite v1 to v2 with step-by-step dependency, package, and configuration updates, plus fixes for common upgrade issues.

### Concepts

> Explore core Thulite concepts that explain framework decisions, including architecture principles, dependency strategy, and project fundamentals.

- [Why Thulite?](https://docs.thulite.io/start-here/concepts/why-thulite/): Learn why Thulite exists, what principles shape it, and how its architecture, performance, security, and developer focus support modern websites.
- [Dependencies](https://docs.thulite.io/start-here/concepts/dependencies/): Understand how Thulite manages dependencies with npm and Hugo modules, why this approach was chosen, and the trade-offs versus alternatives.

## Basics

> Learn Thulite basics, from content and layouts to assets, integrations, templates, and deployment, so you can build and ship sites confidently.

- [Project Structure](https://docs.thulite.io/basics/project-structure/): Understand the Thulite project structure and where to place content, configuration, templates, assets, and static files for smooth workflows.
- [Pages](https://docs.thulite.io/basics/pages/): Create and organize Thulite pages with regular files, leaf bundles, and branch bundles while controlling URL structure through content paths.
- [Markdown](https://docs.thulite.io/basics/markdown/): Write Thulite content with Markdown syntax, frontmatter, code blocks, and media patterns that keep documentation readable and easy to maintain.
- [Shortcodes](https://docs.thulite.io/basics/shortcodes/): Use and create Hugo shortcodes in Thulite to embed reusable UI patterns in Markdown, keeping content expressive and template logic reusable.
- [Archetypes](https://docs.thulite.io/basics/archetypes/): Define archetypes to standardize frontmatter for new content, reduce repetitive editing, and keep metadata consistent across sections in Thulite.
- [Layouts](https://docs.thulite.io/basics/layouts/): Understand Thulite layout files, partial structure, and Hugo template lookup so you can customize how home, list, and single pages are rendered.
- [Partials](https://docs.thulite.io/basics/partials/): Build reusable partial templates in Thulite layouts to share rendering logic, reduce duplication, and keep template code maintainable.
- [Menus](https://docs.thulite.io/basics/menus/): Configure multilingual navigation menus in Thulite with menu files, weights, and page references for clear main, social, and footer navigation.
- [Styles](https://docs.thulite.io/basics/styles/): Customize Thulite styling with SCSS variables and custom stylesheets, then rely on the build pipeline for compiled and optimized CSS output.
- [Scripts](https://docs.thulite.io/basics/scripts/): Add custom JavaScript in Thulite using assets/js, DOM-ready patterns, and focused behaviors that improve interactivity without slowing pages.
- [Images](https://docs.thulite.io/basics/images/): Organize and reference images in Thulite using practical paths, accessible alt text, and asset guidelines that keep pages clear and performant.
- [Fonts](https://docs.thulite.io/basics/fonts/): Self-host fonts in Thulite with Fontsource, Hugo mounts, and SCSS variables to improve privacy, consistency, and performance across your site.
- [Templates](https://docs.thulite.io/basics/templates/): Browse Thulite templates and themes to pick the best starting point for blogs, docs, or custom sites based on your design and workflow needs.
- [Integrations](https://docs.thulite.io/basics/integrations/): Explore Thulite integrations that extend styling, metadata, media handling, and core capabilities, and choose the packages your project needs.
- [Deployment](https://docs.thulite.io/basics/deployment/): Browse Thulite deployment guides for popular hosting platforms and choose the setup that matches your workflow, build process, and infrastructure.

### Templates

> Browse Thulite templates and themes to pick the best starting point for blogs, docs, or custom sites based on your design and workflow needs.

- [Templates Overview](https://docs.thulite.io/basics/templates/overview/): Compare official Thulite templates, including starters and themes, to choose a foundation that matches your content model and styling approach.
- [Basic](https://docs.thulite.io/basics/templates/basic/): Choose the Basic starter for a minimal Thulite foundation that prioritizes simplicity, speed, and straightforward project customization.
- [Bolt](https://docs.thulite.io/basics/templates/bolt/): Choose the Bolt theme for a lightweight Thulite blog experience focused on readability, clean design, and high performance.
- [Bootstrap](https://docs.thulite.io/basics/templates/bootstrap/): Choose the Bootstrap starter for Thulite to build responsive pages quickly with preconfigured Bootstrap styles and components.
- [Doks](https://docs.thulite.io/basics/templates/doks/): Choose the Doks theme for modern Thulite documentation sites with strong readability, search, i18n, and versioning support.
- [Tailwind CSS](https://docs.thulite.io/basics/templates/tailwind-css/): Choose the Tailwind CSS starter for Thulite to build quickly with utility-first styling and flexible design customization.

### Integrations

> Explore Thulite integrations that extend styling, metadata, media handling, and core capabilities, and choose the packages your project needs.

- [Integrations Overview](https://docs.thulite.io/basics/integrations/overview/): Review official Thulite integrations for themes, CSS frameworks, images, SVG, and SEO so you can extend projects with supported tooling.
- [Bolt core](https://docs.thulite.io/basics/integrations/bolt-core/): Use the Bolt core integration to power the Bolt theme in Thulite, enabling theme features and smoother customization workflows.
- [Bootstrap](https://docs.thulite.io/basics/integrations/bootstrap/): Use the official Bootstrap integration for Thulite to build responsive interfaces with familiar components and streamlined setup.
- [Core](https://docs.thulite.io/basics/integrations/core/): Learn about Thulite core, the foundational integration that provides essential services and interoperability across the framework ecosystem.
- [Doks core](https://docs.thulite.io/basics/integrations/doks-core/): Use Doks core to power the Doks theme in Thulite, supporting documentation-focused features and consistent theme behavior.
- [Images](https://docs.thulite.io/basics/integrations/images/): Use the official Thulite Images integration to optimize media handling and deliver responsive images with a workflow designed for Hugo sites.
- [Inline SVG](https://docs.thulite.io/basics/integrations/inline-svg/): Use the official Inline SVG integration for Thulite to embed SVG assets in templates and content with flexible rendering support.
- [SEO](https://docs.thulite.io/basics/integrations/seo/): Use the official SEO integration for Thulite to manage metadata and improve search visibility, sharing previews, and content discoverability.
- [Tailwind CSS](https://docs.thulite.io/basics/integrations/tailwindcss/): Use the Tailwind CSS integration for Thulite to enable utility-first styling and rapid interface development in your project.

### Deployment

> Browse Thulite deployment guides for popular hosting platforms and choose the setup that matches your workflow, build process, and infrastructure.

- [Deployment Overview](https://docs.thulite.io/basics/deployment/overview/): Compare deployment options for Thulite and follow platform-specific guides to configure builds, publish public output, and launch reliably.
- [AWS Amplify](https://docs.thulite.io/basics/deployment/aws-amplify/): Deploy Thulite to AWS Amplify with Git-based continuous deployment, custom amplify.yml settings, and correct build output from the public folder.
- [Cloudflare Pages](https://docs.thulite.io/basics/deployment/cloudflare-pages/): Deploy Thulite to Cloudflare Pages using Git integration or Wrangler, with correct build commands, output settings, and optional local preview.
- [Github Pages](https://docs.thulite.io/basics/deployment/github-pages/): Host a Thulite site on GitHub Pages with a GitHub Actions workflow that builds, publishes artifacts, and deploys automatically on pushes.
- [Gitlab Pages](https://docs.thulite.io/basics/deployment/gitlab-pages/): Deploy Thulite to GitLab Pages using a CI pipeline that installs dependencies, runs production builds, and publishes the public directory.
- [Google Firebase](https://docs.thulite.io/basics/deployment/google-firebase/): Deploy Thulite with Firebase Hosting by configuring firebase files, building your site, and publishing the public output with the Firebase CLI.
- [Microsoft Azure](https://docs.thulite.io/basics/deployment/microsoft-azure/): Deploy Thulite to Azure Static Web Apps from GitHub using the VS Code extension, generated workflows, and compatible Node and Hugo versions.
- [Netlify](https://docs.thulite.io/basics/deployment/netlify/): Deploy Thulite to Netlify through the web UI or CLI, configure build and publish settings, and manage runtime versions for reliable builds.
- [Render](https://docs.thulite.io/basics/deployment/render/): Deploy Thulite to Render by connecting a repository, setting build and publish options, and configuring a compatible Node.js version for builds.
- [Vercel](https://docs.thulite.io/basics/deployment/vercel/): Deploy Thulite to Vercel with automatic project detection via UI or CLI, then use preview and production deployments from your Git workflow.

## Advanced

> Explore advanced Thulite topics for performance, security, SEO, analytics, CMS integration, and multilingual sites to improve production readiness.

- [Internationalization](https://docs.thulite.io/advanced/internationalization/): Set up multilingual Thulite sites using Hugo language config, translated content paths, and i18n string files for consistent localized experiences.
- [Performance](https://docs.thulite.io/advanced/performance/): Improve Thulite performance with guides on caching and optimization to speed builds, reduce payloads, and deliver faster production pages.
- [Security](https://docs.thulite.io/advanced/security/): Strengthen Thulite security with guidance on CSP, response headers, and email obfuscation to reduce common web risks in production.
- [SEO](https://docs.thulite.io/advanced/seo/): Access advanced SEO guidance in Thulite to strengthen crawlability, metadata quality, and search performance across production content.
- [Analytics](https://docs.thulite.io/advanced/analytics/): Add analytics to Thulite with provider guides that balance measurement needs, privacy requirements, and straightforward implementation.
- [CMS](https://docs.thulite.io/advanced/cms/): Explore CMS integration options for Thulite and choose a Git-based workflow that fits your content editing, publishing, and team process.

### Performance

> Improve Thulite performance with guides on caching and optimization to speed builds, reduce payloads, and deliver faster production pages.

- [Performance Overview](https://docs.thulite.io/advanced/performance/overview/): Improve Thulite build and runtime performance with focused guidance on caching strategy, payload reduction, and high-impact optimization steps.
- [Caching](https://docs.thulite.io/advanced/performance/caching/): Configure Thulite caching for faster builds and repeat visits using Hugo cache settings, fingerprinted assets, and effective edge cache headers.
- [Optimization](https://docs.thulite.io/advanced/performance/optimization/): Optimize Thulite output with production builds, lean CSS/JS, deferred non-critical work, and verification practices for better Core Web Vitals.

### Security

> Strengthen Thulite security with guidance on CSP, response headers, and email obfuscation to reduce common web risks in production.

- [Security Overview](https://docs.thulite.io/advanced/security/overview/): Apply core security protections in Thulite with practical guidance for CSP, secure headers, and anti-scraping techniques for public websites.
- [Content Security Policy](https://docs.thulite.io/advanced/security/content-security-policy/): Create and enforce a strict Content Security Policy in Thulite to limit resource origins, reduce XSS risk, and validate changes safely.
- [Headers](https://docs.thulite.io/advanced/security/headers/): Set a secure header baseline for Thulite deployments, including HSTS, nosniff, framing controls, and policies for safer browser behavior.
- [Email Obfuscation](https://docs.thulite.io/advanced/security/email-obfuscation/): Protect published email addresses in Thulite using CSS-based obfuscation that remains readable for users while reducing basic scraping.

### SEO

> Access advanced SEO guidance in Thulite to strengthen crawlability, metadata quality, and search performance across production content.

- [SEO Overview](https://docs.thulite.io/advanced/seo/overview/): Improve Thulite SEO with practical guidance for metadata, crawl signals, and visibility using the official SEO documentation and best practices.

### Analytics

> Add analytics to Thulite with provider guides that balance measurement needs, privacy requirements, and straightforward implementation.

- [Analytics Overview](https://docs.thulite.io/advanced/analytics/overview/): Choose an analytics approach for Thulite with setup guides for Cabin, Fathom, Google Analytics, and Plausible implementations.
- [Cabin Analytics](https://docs.thulite.io/advanced/analytics/cabin-analytics/): Add Cabin Analytics to Thulite with a lightweight script integration for privacy-first, low-footprint website measurement and reporting.
- [Fathom Analytics](https://docs.thulite.io/advanced/analytics/fathom-analytics/): Integrate Fathom Analytics with Thulite to measure traffic using a privacy-focused script setup and minimal implementation overhead.
- [Google Analytics](https://docs.thulite.io/advanced/analytics/google-analytics/): Set up Google Analytics 4 in Thulite by enabling Hugo analytics templates, configuring the measurement ID, and aligning CSP settings.
- [Plausible Analytics](https://docs.thulite.io/advanced/analytics/plausible-analytics/): Integrate Plausible Analytics with Thulite using domain parameters and script injection for privacy-friendly traffic tracking in production.

### CMS

> Explore CMS integration options for Thulite and choose a Git-based workflow that fits your content editing, publishing, and team process.

- [CMS Overview](https://docs.thulite.io/advanced/cms/overview/): Choose a headless CMS for Thulite with quick-start guides for CloudCannon, Decap CMS, and Tina CMS to enable editor-friendly workflows.
- [CloudCannon](https://docs.thulite.io/advanced/cms/cloudcannon/): Connect CloudCannon to Thulite for a Git-based visual editing workflow, then manage and publish content through your repository process.
- [Decap Cms](https://docs.thulite.io/advanced/cms/decap-cms/): Integrate Decap CMS with Thulite using Git-backed content editing and configurable collections that map directly to your Markdown structure.
- [Tina CMS](https://docs.thulite.io/advanced/cms/tina-cms/): Set up Tina CMS in a Thulite project, configure collections and scripts, and enable Git-backed editing for local and production workflows.

## Reference

> Use this reference section to quickly find authoritative details on Thulite CLI, commands, configuration fields, and Markdown syntax behavior.

- [CLI](https://docs.thulite.io/reference/cli/): Reference all create-thulite CLI arguments and options, including templates, interactive mode, overwrite behavior, and usage examples.
- [Commands](https://docs.thulite.io/reference/commands/): Reference Thulite project scripts for creating content, running development, formatting, building production output, and previewing locally.
- [Configuration](https://docs.thulite.io/reference/configuration/): Navigate Thulite configuration references for file structure, core Hugo settings, parameters, and page frontmatter fields used in projects.
- [Markdown](https://docs.thulite.io/reference/markdown/): Find Markdown reference guides used in Thulite, covering basic and extended syntax supported by Hugo for writing consistent content.

### Configuration

> Navigate Thulite configuration references for file structure, core Hugo settings, parameters, and page frontmatter fields used in projects.

- [Configuration Overview](https://docs.thulite.io/reference/configuration/overview/): Use this overview to find Thulite configuration references for project structure, Hugo settings, site parameters, and page frontmatter fields.
- [Configuration Structure](https://docs.thulite.io/reference/configuration/configuration-structure/): Understand the Thulite configuration layout, including default, environment-specific, and tooling files used to control build and site behavior.
- [Settings](https://docs.thulite.io/reference/configuration/settings/): Reference core Hugo settings used by Thulite, including URLs, outputs, caching, taxonomies, minification, and related-content options.
- [Parameters](https://docs.thulite.io/reference/configuration/parameters/): Reference key Thulite site parameters in params.toml, including metadata defaults and render hook behavior for links and images.
- [Page Frontmatter](https://docs.thulite.io/reference/configuration/page-frontmatter/): Reference page frontmatter fields in Thulite content files, including metadata, draft state, ordering, and page-specific SEO options.

### Markdown

> Find Markdown reference guides used in Thulite, covering basic and extended syntax supported by Hugo for writing consistent content.

- [Markdown Overview](https://docs.thulite.io/reference/markdown/overview/): Learn how Markdown works in Thulite with Hugo support for CommonMark basics and extended syntax features for richer documentation content.
- [Basic Syntax](https://docs.thulite.io/reference/markdown/basic-syntax/): Reference core Markdown syntax supported across tools, including headings, emphasis, lists, links, images, blockquotes, and inline code.
- [Extended Syntax](https://docs.thulite.io/reference/markdown/extended-syntax/): Reference extended Markdown syntax like tables, footnotes, task lists, and fenced code blocks, plus unsupported elements in Hugo Markdown.