# Examples and templates

> Get started with a template or explore some Docsy-based sites

---

LLMS index: [llms.txt](/llms.txt)

---

<link rel="preload" as="image" href="/examples/background-pexels-peter-de-vink-288978-849403_hu_4ed15a88481041c9.jpg" media="(max-width: 1200px)">
<link rel="preload" as="image" href="/examples/background-pexels-peter-de-vink-288978-849403_hu_951c3af05187cb00.jpg" media="(min-width: 1200px)">
<style>
#td-cover-block-0 {
  background-image: url(/examples/background-pexels-peter-de-vink-288978-849403_hu_4ed15a88481041c9.jpg);
}
@media only screen and (min-width: 1200px) {
  #td-cover-block-0 {
    background-image: url(/examples/background-pexels-peter-de-vink-288978-849403_hu_951c3af05187cb00.jpg);
  }
}
</style>
<section id="td-cover-block-0" class="row td-cover-block td-cover-block--height-min td-below-navbar js-td-cover td-overlay td-overlay--dark -bg-dark" >
  <div class="col-12">
    <div class="container td-overlay__inner">
      <div class="text-center">
        <h1 class="display-1 mt-0 mt-md-5 pb-4">Examples and templates</h1>
        <div class="pt-3 lead">
          

<!-- prettier-ignore -->
Get started with a template or explore some Docsy-based sites
{.display-6}

</div>
      </div>
    </div>
  </div>
  
</section>


<div><a id="td-block-1" class="td-anchor-no-extra-offset"></a></div>
<section class="row td-box td-box--white td-box--height-auto">
<div class="col">
<div class="container">



One of the best ways to see what Docsy can do, and learn how to configure a site
with it, is to see some real projects. Of course, we use Docsy for this site.
For the site source, see [docsy.dev][docsy.dev-repo].

<div class="row row-cols-1 row-cols-md-2 g-4 mb-4">
  <div class="col">
    <div class="card h-100 shadow-sm">
      <img
        src="docsy-example-home.jpg"
        class="card-img-top"
        alt="Goldydocs starter template homepage"
      />
      <div class="card-body">
        <div class="h5 card-title mb-2"><a href="https://example.docsy.dev">Goldydocs</a></div>
        <p class="card-text">The main Docsy example site starter template.</p>
      </div>
    </div>
  </div>

  <div class="col">
    <div class="card h-100 shadow-sm">
      <img
        src="docsy-starter-home.jpg"
        class="card-img-top"
        alt="Docsy starter template homepage"
      />
      <div class="card-body">
        <div class="h5 card-title mb-2"><a href="https://cncf-docsy-starter.netlify.app/">Docsy starter</a></div>
        <p class="card-text">An opinionated starter including CI/CD setup.</p>
      </div>
    </div>
  </div>
</div>

## Starter templates

The Docsy project provides two site starter templates:

| Site                               | Repo                                      | Docsy            |
| ---------------------------------- | ----------------------------------------- | ---------------- |
| [Goldydocs][] - main Docsy example | <https://github.com/google/docsy-example>       | v0.14.1 (latest) |
| [Docsy starter][]                  | <https://github.com/chalin/docsy-starter> | v0.14.1 (latest) |

In addition to these example starters, there are several live sites using the
theme. Consider adding your Docsy-based site to this page once you have a
production site up and running.

Thumbnails for the starter templates are shown above. Both use a hero image. For
an example of a cover that is a gradient of the primary theme color, see this
[test Homepage][].

[test Homepage]: /tests/blocks-cover/color-gradient/

## Docsy theme examples

Example sites that have low to no customization:

| Site                                                | Repo                                                         |
| --------------------------------------------------- | ------------------------------------------------------------ |
| [docsy.dev](/) (this site)                          | <https://github.com/google/docsy/tree/main/docsy.dev>              |
| [AgileBase docs](https://docs.agilebase.co.uk/)     | https://github.com/okohll/abdocs                             |
| [Agones.dev](https://agones.dev/site/)              | https://github.com/googleforgames/agones/tree/main/site      |
| [Apache Parquet](https://parquet.apache.org/)       | https://parquet.apache.org                                   |
| [CloudWeGo.io](https://www.cloudwego.io/)           | https://github.com/cloudwego/cloudwego.github.io             |
| [etcd.io](https://etcd.io/)                         | https://github.com/etcd-io/website                           |
| [fission.io](https://fission.io/)                   | https://github.com/fission/fission.io                        |
| [fluxcd.io](https://fluxcd.io)                      | https://github.com/fluxcd/website                            |
| [Graphviz](https://graphviz.org)                    | https://gitlab.com/graphviz/graphviz.gitlab.io               |
| [gRPC](https://www.grpc.io/)                        | https://github.com/grpc/grpc.io                              |
| [JVMPerf.net](https://jvmperf.net/)                 | https://github.com/cchesser/java-perf-workshop               |
| [Kubeflow.org](https://www.kubeflow.org/)           | https://github.com/kubeflow/website                          |
| [Layer5 Docs](https://docs.layer5.io/)              | https://github.com/layer5io/docs                             |
| [Navidrome Music Server](https://www.navidrome.org) | https://github.com/navidrome/website                         |
| [OpenTelemetry.io](https://opentelemetry.io)        | https://github.com/open-telemetry/opentelemetry.io           |
| [protobuf.dev](https://protobuf.dev)                | https://github.com/protocolbuffers/protocolbuffers.github.io |
| [Selenium.dev](https://www.selenium.dev/)           | https://github.com/SeleniumHQ/seleniumhq.github.io           |
| [Stroom.io](https://gchq.github.io/stroom-docs)     | https://github.com/gchq/stroom-docs                          |
| [tekton.dev](https://tekton.dev/)                   | https://github.com/tektoncd                                  |
| [YMCA Website Services](https://ds-docs.y.org/)     | https://github.com/YCloudYUSA/yusaopeny_docs                 |

## Customized Docsy examples

Example sites that include a moderate to high amount of customization:

| Site                                                 | Repo                                           |
| ---------------------------------------------------- | ---------------------------------------------- |
| [Apache Airflow](https://airflow.apache.org/)        | https://github.com/apache/airflow-site/        |
| [Docsy Mostly Docs](https://mostlydocs.netlify.app/) | https://github.com/gwatts/mostlydocs/          |
| [Kubernetes](https://kubernetes.io)                  | https://github.com/kubernetes/website          |
| [XLT](https://xltdoc.xceptance.com/)                 | https://github.com/Xceptance/xlt-documentation |
| [Dapr](https://docs.dapr.io/)                        | https://github.com/dapr/docs                   |

[Docsy starter]: https://cncf-docsy-starter.netlify.app/
[docsy.dev-repo]: <https://github.com/google/docsy/tree/main/docsy.dev>
[Goldydocs]: <https://example.docsy.dev>

</div>
</div>
</section>