Frequently Asked Questions

Find answers to common questions about Astro Boilerplate.

What is Astro Boilerplate?

Astro Boilerplate is a production-ready starter template for building modern websites with Astro, Keystatic CMS, and Tailwind CSS v4. It features a beautiful botanical design system with dark mode support.

How do I get started?

Clone the repository, run npm install to install dependencies, set up your Keystatic project, customize the design tokens, and deploy to Cloudflare Pages. Check the README for detailed instructions.

What is Keystatic?

Keystatic is a headless CMS that provides a beautiful UI for editing content while storing everything in your Git repository. It offers the benefits of a CMS without the complexity of a traditional database.

Is dark mode supported?

Yes! The boilerplate includes a fully-featured dark mode implementation with system preference detection, localStorage persistence, and smooth transitions between themes.

Can I deploy to other platforms?

While the boilerplate is optimized for Cloudflare Pages, you can deploy to any static hosting provider like Vercel, Netlify, or GitHub Pages. Just remove the Cloudflare adapter from astro.config.mjs.

How do I customize the colors?

Colors are defined as CSS custom properties in src/styles/global.css. You can modify the light and dark mode color tokens in the :root and .dark selectors.

Is TypeScript required?

TypeScript is included and configured with strict mode, but you can use plain JavaScript if you prefer. The boilerplate is designed to work well with either.

How do I add new pages?

Create new .astro files in the src/pages directory. Astro uses file-based routing, so pages/ about.astro becomes /about. You can also create dynamic routes using [param].astro files.

What about SEO?

The boilerplate includes built-in SEO features like automatic sitemap generation, proper meta tags, Open Graph tags, and structured data. Each page can customize its SEO metadata via the Layout component.

How do I contact support?

You can reach us through the contact form on this website or email us directly at [email protected].

Still have questions?

Can't find the answer you're looking for? Feel free to reach out to us.

Contact Us