スターター
スターターは、SpiraCSS のプロジェクト設定(Stylelint / HTML CLI など)をあらかじめ用意した最小構成のサンプルです。
エディターで SCSS 生成や @rel ナビゲーションを試す場合は、VS Code 拡張を別途インストールしてください。
フレームワークが変わっても、同じ SCSS
各スターターでは、CSS Modules、Vue の <style scoped>、Astro の自動スコープの代わりに、標準 CSS の @scope を使っています。6つのスターターと SCSS 構造リファレンスで、まったく同じ SCSS ファイルを共有しています。
同じ SCSS を使うには、その SCSS が対象とする HTML 構造とクラス名を揃えます。テンプレートの書き方と SCSS の読み込み方は、各フレームワークに合わせます。違いは下の一覧で確認できます。
ルートだけをスコープにする
コンポーネントルートの SCSS は次のようになります(抜粋)。
@use "sass:meta";
@scope (.hero-section) { :scope { @include meta.load-css("scss");
> .hero-description { margin-top: 1.5rem; } }}scss/ から読み込む子 Block は通常のクラス形式にし、@scope を重ねません。ルートの meta.load-css() は :scope の内側に置きます。
グローバルのリセットや変数は、コンポーネントのスコープの外に置きます。
@scope は現行の主要ブラウザで利用できる標準 CSS 機能です(Baseline 2026)。旧ブラウザも対象にする場合は対応状況を確認してください。
ルート書式
SpiraCSS の設計自体は @scope や @layer を必須としません。
スターターは、HTML CLI と VS Code 拡張の既定のルート書式 scope-explicit を使っています。コンポーネントルートをクラス形式で書く場合は generator.scssRootStyle: 'class' を指定します。詳しくは設定オプションのルート書式を参照してください。
試せること
- SpiraCSS のクラス構造(Block/Element、1ファイル1Block)
- 標準 CSS の
@scopeで書くコンポーネントルート - バリアント/ステートの設計(デフォルトは data 属性)
- HTML -> SCSS 生成(VS Code 拡張 / HTML CLI)
- Stylelint のルール検証とエラーメッセージ
@relコメントのナビゲーション(Comment Links 拡張)
基礎
- SCSS 構造リファレンス: spiracss-scss-structure
一覧
| Stack | Starter | 構成 | SCSS 読み込み |
|---|---|---|---|
| Vanilla(Vite) | spiracss-starter-vanilla | 静的 HTML | HTML でエントリ SCSS を読み込み |
| Eleventy | spiracss-starter-eleventy | WebC テンプレート + include | テンプレートでビルド済み CSS を読み込み |
| Astro | spiracss-starter-astro | Astro コンポーネント | layout + エントリ SCSS を import |
| Next.js | spiracss-starter-next | React コンポーネント | 共通 SCSS は root layout、ページ SCSS は各 route から import |
| Next.js | spiracss-starter-next-global | React コンポーネント | 共通・ページ SCSS を root layout からまとめて import |
| Nuxt | spiracss-starter-nuxt | Vue コンポーネント | 設定で共通 SCSS、各ページでエントリ SCSS を import |
動かす前に
スターターは Node.js 24.22.2(24 LTS)/npm 11.19.1 に揃えています。各リポジトリの README、.node-version/.nvmrc、lockfile に従ってセットアップしてください。
検証
npm run verify:scss で、共通 SCSS が基準と一致しているか、ルートと子 Block の書式が正しいかを確認できます。依存関係の監査結果は各リポジトリの SECURITY.md に記載しています。
表示の確認
6つのスターターのトップと About ページは、検証した PC・モバイルの画面サイズで、Chromium 上の表示が一致しています。
確認条件(2026年10月29日):PC 1366×900、モバイル 390×844・モバイル UA、いずれも DPR 1。フォント読み込みとアニメーション完了後に、ページ全体のスクリーンショットをマスクや許容誤差なしで比較しました。他のブラウザエンジンや表示幅では検証していません。