Branding
Make your documentation feel like your own project: point your logo, add a custom domain, and replace the auto-generated homepage with your own home page.
Note
homeandlandingare meant for a simple landing page for your project. If you find yourself reaching for a build system, a multi-page marketing site, or other complex tooling, please reach out and we will help you find a good setup. It is often simpler to leave your main website as it is and scope the docs todocs.yourproject.comoryourproject.com/documentation, rather than recreating a complex site here.
Custom homepage
Set home to an HTML file in your repository. It is injected into the page's <main> and wrapped in your site's navigation, so the header stays consistent. Everything inside is plain HTML that you lay out and style yourself.
Tip
Add a
<style>block anywhere in your snippet. It is included as-is, so your own CSS applies immediately, and you can style the page however you like.
<style>
.hero {
display: grid;
gap: 1.5rem;
padding: 4rem 1rem;
text-align: center;
}
.hero h1 {
font-size: 3rem;
}
</style>
<section class="hero">
<h1>Your Project</h1>
<p>A short tagline about what it does.</p>
<a href="/documentation">Read the docs</a>
</section>Full control
For complete control over the whole page, including the <head>, custom fonts and scripts, use landing instead of home. It is served exactly as-is at the root of your domain, with no navigation added.