turbo-themes 0.23.3 → 0.23.5
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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +12 -0
- data/README.md +61 -0
- data/lib/turbo-themes/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 0b3e1b76a7780793061d255d013c5ebe9bf5af0a95aa8bca139158c46b950979
|
|
4
|
+
data.tar.gz: 55d5ad04ababb4b8dc46a9c24fb9c6276c2d7598eb7a8c9350d3c708e9327dfd
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 51d49906700a6225a42f863daa3da143e7704692b301f19509877a7d32da99156fb05d6af3151597f10ff944ed049c1b342ec34eb53c490f5b87972b01776939
|
|
7
|
+
data.tar.gz: 6e91334928b2efdcdf3c39e6f51e8b57b963993690c57f2e4ac25f770b83c94e8a8b1002cbaaad547136ed128bd99ce67b9fcaf54c7f12a0fa809fd777c12803
|
data/CHANGELOG.md
CHANGED
|
@@ -10,6 +10,18 @@ The format is based on Keep a Changelog and this project adheres to SemVer.
|
|
|
10
10
|
|
|
11
11
|
- TBD
|
|
12
12
|
|
|
13
|
+
## [0.23.5] - 2026-07-18
|
|
14
|
+
|
|
15
|
+
### 🔧 Changed
|
|
16
|
+
|
|
17
|
+
- add Astro + GitHub Pages integration guide (#564)
|
|
18
|
+
|
|
19
|
+
## [0.23.4] - 2026-07-17
|
|
20
|
+
|
|
21
|
+
### 🔧 Changed
|
|
22
|
+
|
|
23
|
+
- document consumer theme curation patterns (#565)
|
|
24
|
+
|
|
13
25
|
## [0.23.3] - 2026-07-17
|
|
14
26
|
|
|
15
27
|
### 🔧 Changed
|
data/README.md
CHANGED
|
@@ -142,6 +142,67 @@ let mocha = ThemeRegistry.themes[.catppuccinMocha]
|
|
|
142
142
|
| `@lgtm-hq/turbo-themes/tokens` | TypeScript tokens with types |
|
|
143
143
|
| `@lgtm-hq/turbo-themes/css/*` | Pre-built CSS files |
|
|
144
144
|
|
|
145
|
+
## Choosing Themes
|
|
146
|
+
|
|
147
|
+
Turbo Themes ships with 24 curated themes. Use the existing API exports to build a
|
|
148
|
+
catalog that stays in sync with the package automatically.
|
|
149
|
+
|
|
150
|
+
### Utility exports
|
|
151
|
+
|
|
152
|
+
```typescript
|
|
153
|
+
import {
|
|
154
|
+
themeIds, // readonly string[] — all 24 IDs
|
|
155
|
+
flavors, // ThemeFlavor[] — full metadata
|
|
156
|
+
getThemesByVendor, // filter by vendor string
|
|
157
|
+
getThemesByAppearance, // filter by 'dark' | 'light'
|
|
158
|
+
} from '@lgtm-hq/turbo-themes';
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
### Consumer curation patterns
|
|
162
|
+
|
|
163
|
+
```typescript
|
|
164
|
+
// a) All themes
|
|
165
|
+
const CATALOG = themeIds;
|
|
166
|
+
|
|
167
|
+
// b) Hardcoded minimal set (copy-paste friendly, no build required)
|
|
168
|
+
const CATALOG = [
|
|
169
|
+
'catppuccin-mocha',
|
|
170
|
+
'catppuccin-latte',
|
|
171
|
+
'dracula',
|
|
172
|
+
'github-dark',
|
|
173
|
+
'github-light',
|
|
174
|
+
];
|
|
175
|
+
|
|
176
|
+
// c) Vendor opt-in — stays in sync automatically
|
|
177
|
+
const CATALOG = getThemesByVendor('catppuccin').map((f) => f.id);
|
|
178
|
+
|
|
179
|
+
// d) Appearance filter
|
|
180
|
+
const darkCatalog = getThemesByAppearance('dark').map((f) => f.id); // 15
|
|
181
|
+
const lightCatalog = getThemesByAppearance('light').map((f) => f.id); // 9
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
> **Planned in [#495](https://github.com/lgtm-hq/turbo-themes/issues/495):** A
|
|
185
|
+
> `themeSets` object (named pre-defined subsets) and a `createThemeCatalog()` factory
|
|
186
|
+
> (filter vendor + appearance in one call) will make these patterns even more concise.
|
|
187
|
+
|
|
188
|
+
### FOUC prevention with `generateBlockingScript()`
|
|
189
|
+
|
|
190
|
+
The `@lgtm-hq/turbo-theme-selector` package exports `generateBlockingScript()`, which
|
|
191
|
+
generates a self-contained inline script from your catalog. Inject it into `<head>` at
|
|
192
|
+
build time to apply the user's saved theme before first paint:
|
|
193
|
+
|
|
194
|
+
```typescript
|
|
195
|
+
import { generateBlockingScript } from '@lgtm-hq/turbo-theme-selector';
|
|
196
|
+
|
|
197
|
+
const script = generateBlockingScript({
|
|
198
|
+
validThemes: ['catppuccin-mocha', 'catppuccin-latte', 'dracula'],
|
|
199
|
+
});
|
|
200
|
+
// Inline the returned string in a <script> tag in <head>
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
See the [theme switching guide](apps/site/src/content/docs/guides/theme-switching.md)
|
|
204
|
+
for a complete walkthrough.
|
|
205
|
+
|
|
145
206
|
## Examples
|
|
146
207
|
|
|
147
208
|
Complete, working examples demonstrating Turbo Themes integration with various
|
data/lib/turbo-themes/version.rb
CHANGED