AstroDocumentation

starlight-theme-black — Astro Documentation Template

By adrian-ub

A black theme for Astro Starlight with a visual style referencing shadcn documentation, released under the MIT license.

Open Source Site Download Source ZIP

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

2 previews

Desktop homepage1 / 2

starlight-theme-black · Desktop homepage

Visit websiteOpens in a new tab

Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

Documentation site theme based on Astro Starlight

Black color scheme with accent color #22c55e

Visual style referencing shadcn documentation

Published as an npm package, installable in Starlight projects

Provides an online demo site with desktop and mobile page screenshots

MIT license, permitting use, modification, commercial use, and distribution

Template Details

starlight-theme-black is an Astro Starlight theme published by adrian-ub, used to replace the default appearance of Starlight documentation sites. Its design is inspired by shadcn's documentation interface, with an overall black tone, a green accent color (#22c55e), and an editorial-leaning layout.

The project is published as an npm package. The README provides badges for npm version, downloads, JSDocs, and license, indicating it can be installed as a dependency in an existing Starlight project. The repository also provides an online demo site, allowing you to view actual desktop and mobile page effects before deciding whether to adopt it.

The materials do not specify which specific components, configuration options, or customizable parameters the theme includes, nor do they provide installation and activation steps. Before use, consult the actual documentation on the repository and npm page.

AstroDocumentation

Is it right for your project?

Use Cases

Changing the black appearance for an Astro Starlight documentation site
Building a technical documentation site with a style close to shadcn documentation
Introducing a third-party theme package into an existing Starlight project

Suitable For

Developers building documentation with Astro Starlight
Teams preferring a black, low-brightness documentation interface
Projects needing an MIT-licensed theme for modification and commercial use

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

1
The README does not provide installation and activation steps; refer to the actual instructions on the repository and npm page.
2
The theme is published as the npm package starlight-theme-black and must be introduced as a dependency in a Starlight project.
3
Third-party assets such as demo images, fonts, and icons require separate license verification; do not judge solely based on the code's MIT license.
4
External services such as domains and hosting may incur additional charges, unrelated to the free scope of the theme code.

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not imply that external services or third-party assets are free.

Must comply with when using

Permits free use, modification, commercial use, and distribution of this version's code.
When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; do not judge solely based on the code's MIT license.
External services such as domains, hosting, databases, payments, or AI may incur additional charges.

View Original Text Basis

Permission is hereby granted, free of charge
Original License Text

https://github.com/adrian-ub/starlight-theme-black/blob/main/LICENSE.md https://github.com/adrian-ub/starlight-theme-black/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms: GitHub
Documentation and maintenance reference score: More documented · 87 / 100
Technologies: Astro
Website type: Documentation

How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded: 2026-07-23
Screenshot last checked: 2026-10-02

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Astro as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 0b3f40831f9758824b1b9ee4181b30d7108ad59d21ba32d3491ca62bb6220ca6

2026-10-02T09:46:31.198Z

Source file / repository

# starlight-theme-black

[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![JSDocs][jsdocs-src]][jsdocs-href]
[![License][license-src]][license-href]

Starlight theme inspired by Shadcn docs

## Sponsors

<p align="center">
  <a href="https://cdn.jsdelivr.net/gh/adrian-ub/static/sponsors.svg">
    <img src='https://cdn.jsdelivr.net/gh/adrian-ub/static/sponsors.svg'/>
  </a>
</p>

## License

[MIT](./LICENSE) License © 2024-PRESENT [Adrián UB](https://github.com/adrian-ub)

<!-- Badges -->

[npm-version-src]: https://img.shields.io/npm/v/starlight-theme-black?style=flat&colorA=080f12&colorB=1fa669
[npm-version-href]: https://npmjs.com/package/starlight-theme-black
[npm-downloads-src]: https://img.shields.io/npm/dm/starlight-theme-black?style=flat&colorA=080f12&colorB=1fa669
[npm-downloads-href]: https://npmjs.com/package/starlight-theme-black
[license-src]: https://img.shields.io/github/license/adrian-ub/starlight-theme-black.svg?style=flat&colorA=080f12&colorB=1fa669
[license-href]: https://github.com/adrian-ub/starlight-theme-black/blob/main/LICENSE
[jsdocs-src]: https://img.shields.io/badge/jsdocs-reference-080f12?style=flat&colorA=080f12&colorB=1fa669
[jsdocs-href]: https://www.jsdocs.io/package/starlight-theme-black

Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

AnvilWiki

AnvilWiki is an Astro static Wiki template for game guide and compendium sites, with a built-in AI content workflow and monetization components. It outputs static pages by default and deploys on Cloudflare Pages, emphasizing zero server cost and out-of-the-box performance.

Astro · Game Site

starlight-theme-rapide

starlight-theme-rapide is an Astro Starlight documentation site theme inspired by the Visual Studio Code Vitesse theme, offering dark and light modes and released under the MIT license.

Astro · Documentation

CelestialDocs

CelestialDocs is an Astro-based documentation platform template that maintains documentation, blog, and product pages in a single repository through a multi-collection architecture.

Astro · Documentation

astro-big-doc

astro-big-doc is an Astro-based documentation site theme that renders standard Markdown and automatically generates a hierarchical menu and table of contents from the file directory structure with zero configuration.

Astro · Documentation

stellar

Stellar is a modern, type-safe documentation theme for Astro, suited for technical documentation sites written in Markdown or MDX. It offers dark mode, type-safe i18n, fuse.js local search, Tailwind styling, the View Transitions API, Shiki code highlighting, and custom import paths.

Astro · Documentation

astro-cloudflare-starter

A static Astro starter for marketing pages, a blog, and Starlight documentation, intended for Cloudflare Pages. Content is managed as Markdown/JSON under src/content with schema validation, and the docs include full-text search.

Astro · Blog