|
| 1 | +--- |
| 2 | +pcx_content_type: how-to |
| 3 | +title: Our site |
| 4 | +meta: |
| 5 | + title: Our site | How we docs |
| 6 | +--- |
| 7 | + |
| 8 | +We use a variety of tools to make our docs site work. You could use these tools to build up your own docs site and - in most cases - do so for free or starting on a free tier. |
| 9 | + |
| 10 | +## Content management system |
| 11 | + |
| 12 | +Our content lives in a public GitHub repository, [`cloudflare-docs`](https://github.com/cloudflare/cloudflare-docs). |
| 13 | + |
| 14 | +GitHub offers a generous [free tier](https://github.com/pricing). |
| 15 | + |
| 16 | +## Search |
| 17 | + |
| 18 | +We use [Algolia](https://www.algolia.com/) as our search provider. |
| 19 | + |
| 20 | +If you have open-source docs, you can be part of the free [DocSearch program](https://docsearch.algolia.com/). |
| 21 | + |
| 22 | +## Site framework |
| 23 | + |
| 24 | +We use [Starlight](https://starlight.astro.build/) for our docs, which is a free, custom documentation theme supported by [Astro](https://astro.build/). |
| 25 | + |
| 26 | +Astro's [component overrides](https://starlight.astro.build/guides/overriding-components/) and [plugins](https://starlight.astro.build/resources/plugins/) system were a big part of us [choosing this framework](https://blog.cloudflare.com/open-source-all-the-way-down-upgrading-our-developer-documentation/) and have exponentially increased our site's capabilities (without much extra work). |
| 27 | + |
| 28 | +## Builds |
| 29 | + |
| 30 | +We use [GitHub Actions](https://github.com/features/actions) to build our site, which is then [hosted](#hosting) on Cloudflare. |
| 31 | + |
| 32 | +We are moving to [Workers CI/CD](/workers/ci-cd/), which currently runs in the background. |
| 33 | + |
| 34 | +Both of these options include a free tier. |
| 35 | + |
| 36 | +## Hosting |
| 37 | + |
| 38 | +We host our content using [Cloudflare Workers](/workers/static-assets/), specifically using their built in values for [Astro sites](/workers/framework-guides/web-apps/astro/) |
| 39 | + |
| 40 | +Workers offers a generous [free tier](/workers/platform/pricing/). |
| 41 | + |
| 42 | +## Analytics |
| 43 | + |
| 44 | +We send analytics to multiple destinations using [Cloudflare Zaraz](/zaraz/), which has a generous [free tier](/zaraz/pricing-info/). |
| 45 | + |
| 46 | +:::note |
| 47 | + |
| 48 | +If you want to opt out of analytics tracking, use the icon at the bottom of your screen. |
| 49 | + |
| 50 | + |
| 51 | + |
| 52 | +::: |
0 commit comments