starlight-theme-celestia 0.2.0 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +87 -0
- package/lib/tailwind.gen.css +1 -1
- package/package.json +7 -3
package/README.md
ADDED
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# starlight-theme-celestia
|
|
2
|
+
|
|
3
|
+
A clean, modern theme for [Astro Starlight](https://starlight.astro.build/), forked from [starlight-theme-nova](https://github.com/ocavue/starlight-theme-nova).
|
|
4
|
+
|
|
5
|
+
## Features
|
|
6
|
+
|
|
7
|
+
- **No sidebar borders** — seamless layout between content and sidebars
|
|
8
|
+
- **Inter font** — self-hosted via `@fontsource/inter`, 14px base size
|
|
9
|
+
- **Wider content** — 55rem content width, 17rem sidebars
|
|
10
|
+
- **3-way theme toggle** — cycles through Auto, Light, and Dark
|
|
11
|
+
- **Warm accent colors** — `#fb923c` (dark) / `#c2410c` (light)
|
|
12
|
+
- **Multi-sidebar ready** — ships `@lorenzo_lewis/starlight-utils` as a dependency
|
|
13
|
+
- **Version dropdown** — built-in `starlight-versions` integration with auto-detected header dropdown
|
|
14
|
+
|
|
15
|
+
## Installation
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
bun add starlight-theme-celestia
|
|
19
|
+
# or
|
|
20
|
+
npm install starlight-theme-celestia
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Usage
|
|
24
|
+
|
|
25
|
+
```js
|
|
26
|
+
import { defineConfig } from "astro/config";
|
|
27
|
+
import starlight from "@astrojs/starlight";
|
|
28
|
+
import starlightCelestiaTheme from "starlight-theme-celestia";
|
|
29
|
+
|
|
30
|
+
export default defineConfig({
|
|
31
|
+
integrations: [
|
|
32
|
+
starlight({
|
|
33
|
+
title: "My Docs",
|
|
34
|
+
plugins: [starlightCelestiaTheme()],
|
|
35
|
+
sidebar: [{ label: "Guide", autogenerate: { directory: "guide" } }],
|
|
36
|
+
}),
|
|
37
|
+
],
|
|
38
|
+
});
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### Options
|
|
42
|
+
|
|
43
|
+
```js
|
|
44
|
+
starlightCelestiaTheme({
|
|
45
|
+
// Navigation items in the header bar
|
|
46
|
+
nav: [
|
|
47
|
+
{ label: "Blog", href: "/blog" },
|
|
48
|
+
{ label: "GitHub", href: "https://github.com" },
|
|
49
|
+
],
|
|
50
|
+
// CSS delivery mode: 'detect' (default), 'css', or 'tailwind'
|
|
51
|
+
stylingSystem: "detect",
|
|
52
|
+
});
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
### Multi-Sidebar
|
|
56
|
+
|
|
57
|
+
The theme ships `@lorenzo_lewis/starlight-utils` as a dependency.
|
|
58
|
+
Add it alongside the theme plugin:
|
|
59
|
+
|
|
60
|
+
```js
|
|
61
|
+
import starlightUtils from "@lorenzo_lewis/starlight-utils";
|
|
62
|
+
|
|
63
|
+
// Inside starlight({ plugins: [...] })
|
|
64
|
+
starlightUtils({
|
|
65
|
+
multiSidebar: {
|
|
66
|
+
switcherStyle: "horizontalList",
|
|
67
|
+
},
|
|
68
|
+
});
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### Versioning
|
|
72
|
+
|
|
73
|
+
The theme ships `starlight-versions` as a dependency. When configured, a version dropdown automatically appears next to the site title:
|
|
74
|
+
|
|
75
|
+
```js
|
|
76
|
+
import starlightVersions from "starlight-versions";
|
|
77
|
+
|
|
78
|
+
// Inside starlight({ plugins: [...] })
|
|
79
|
+
starlightVersions({
|
|
80
|
+
current: { label: "v2.0 (latest)" },
|
|
81
|
+
versions: [{ slug: "v1", label: "v1.0" }],
|
|
82
|
+
});
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## License
|
|
86
|
+
|
|
87
|
+
MIT
|
package/lib/tailwind.gen.css
CHANGED
package/package.json
CHANGED
|
@@ -1,9 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "starlight-theme-celestia",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "0.2.
|
|
4
|
+
"version": "0.2.2",
|
|
5
5
|
"description": "A clean, modern theme for Astro Starlight",
|
|
6
6
|
"license": "MIT",
|
|
7
|
+
"repository": {
|
|
8
|
+
"type": "git",
|
|
9
|
+
"url": "git+https://github.com/devxygmbh/starlight-theme-celestia.git"
|
|
10
|
+
},
|
|
7
11
|
"sideEffects": false,
|
|
8
12
|
"main": "./src/index.ts",
|
|
9
13
|
"exports": {
|
|
@@ -48,9 +52,9 @@
|
|
|
48
52
|
"@astrojs/starlight": "^0.38.3",
|
|
49
53
|
"@tailwindcss/cli": "^4.2.2",
|
|
50
54
|
"@tailwindcss/vite": "^4.2.2",
|
|
51
|
-
"@types/node": "^
|
|
55
|
+
"@types/node": "^25.0.0",
|
|
52
56
|
"astro": "^6.1.6",
|
|
53
57
|
"tailwindcss": "^4.2.2",
|
|
54
|
-
"typescript": "^
|
|
58
|
+
"typescript": "^6.0.0"
|
|
55
59
|
}
|
|
56
60
|
}
|