コンテンツにスキップ

スターター

スターターは、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 拡張)

基礎

一覧

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。フォント読み込みとアニメーション完了後に、ページ全体のスクリーンショットをマスクや許容誤差なしで比較しました。他のブラウザエンジンや表示幅では検証していません。