@squadbase/vantage-template 0.1.1-dev1.6b30e42 → 0.1.1-dev1.6ed50bb
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 +1 -1
- package/base-template/.squadbase/skills/vantage-add-feature/SKILL.md +5 -0
- package/base-template/.squadbase/skills/vantage-design/SKILL.md +25 -27
- package/base-template/.squadbase/skills/vantage-design/references/extract.md +10 -13
- package/base-template/.squadbase/skills/vantage-design/references/format.md +12 -173
- package/base-template/.squadbase/skills/vantage-design/references/presets.md +0 -10
- package/base-template/.squadbase/skills/vantage-pitfalls/SKILL.md +5 -0
- package/base-template/.squadbase/skills/vantage-slide/SKILL.md +54 -36
- package/base-template/AGENTS.md +48 -19
- package/base-template/agents/api.md +7 -0
- package/base-template/agents/doc.md +48 -0
- package/base-template/agents/page.md +59 -2
- package/base-template/agents/slide.md +77 -3
- package/base-template/bun.lock +25 -25
- package/base-template/package.json +2 -2
- package/base-template/src/_layout.tsx +7 -0
- package/base-template/src/components/user-card.tsx +1 -1
- package/base-template/src/index.tsx +1 -1
- package/dist/index.js +14 -14
- package/package.json +2 -2
- package/base-template/DESIGN.md +0 -109
|
@@ -68,7 +68,7 @@ const CHARTS = [
|
|
|
68
68
|
export default function HomePage() {
|
|
69
69
|
// `data-vantage-sample` marks this page as the untouched template sample (the coding
|
|
70
70
|
// agent looks for it). Remove it together with the sample content.
|
|
71
|
-
const sampleNote =
|
|
71
|
+
const sampleNote = document.documentElement.lang.startsWith("ja")
|
|
72
72
|
? "サンプルデータです。お手元のデータに置き換えて始めましょう。"
|
|
73
73
|
: "Sample data — replace with your own to get started."
|
|
74
74
|
|
package/dist/index.js
CHANGED
|
@@ -1146,8 +1146,8 @@ var buildThemeCss = (cssVars) => [
|
|
|
1146
1146
|
var THEME_PRESETS_DATA = [
|
|
1147
1147
|
{
|
|
1148
1148
|
"id": "neutral",
|
|
1149
|
-
"title": "
|
|
1150
|
-
"description": "
|
|
1149
|
+
"title": "Neutral",
|
|
1150
|
+
"description": "A preset that restores the default neutral theme. It has the same values as the base theme and is the starting point when switching presets.",
|
|
1151
1151
|
"cssVars": {
|
|
1152
1152
|
"light": {
|
|
1153
1153
|
"radius": "0.5rem",
|
|
@@ -1253,8 +1253,8 @@ var THEME_PRESETS_DATA = [
|
|
|
1253
1253
|
},
|
|
1254
1254
|
{
|
|
1255
1255
|
"id": "ocean",
|
|
1256
|
-
"title": "
|
|
1257
|
-
"description": "
|
|
1256
|
+
"title": "Ocean",
|
|
1257
|
+
"description": "A blue preset with a calm, trustworthy palette and slightly smaller, squarer corners than the default.",
|
|
1258
1258
|
"cssVars": {
|
|
1259
1259
|
"light": {
|
|
1260
1260
|
"radius": "0.375rem",
|
|
@@ -1360,8 +1360,8 @@ var THEME_PRESETS_DATA = [
|
|
|
1360
1360
|
},
|
|
1361
1361
|
{
|
|
1362
1362
|
"id": "forest",
|
|
1363
|
-
"title": "
|
|
1364
|
-
"description": "
|
|
1363
|
+
"title": "Forest",
|
|
1364
|
+
"description": "A green preset with slightly smaller corners. The font is a rounded sans-serif (ui-rounded in Safari, Hiragino Maru Gothic on macOS and iOS, the default font elsewhere).",
|
|
1365
1365
|
"cssVars": {
|
|
1366
1366
|
"light": {
|
|
1367
1367
|
"radius": "0.5rem",
|
|
@@ -1467,8 +1467,8 @@ var THEME_PRESETS_DATA = [
|
|
|
1467
1467
|
},
|
|
1468
1468
|
{
|
|
1469
1469
|
"id": "sunset",
|
|
1470
|
-
"title": "
|
|
1471
|
-
"description": "
|
|
1470
|
+
"title": "Sunset",
|
|
1471
|
+
"description": "An orange preset with a warm palette and slightly larger corners.",
|
|
1472
1472
|
"cssVars": {
|
|
1473
1473
|
"light": {
|
|
1474
1474
|
"radius": "0.75rem",
|
|
@@ -1574,8 +1574,8 @@ var THEME_PRESETS_DATA = [
|
|
|
1574
1574
|
},
|
|
1575
1575
|
{
|
|
1576
1576
|
"id": "violet",
|
|
1577
|
-
"title": "
|
|
1578
|
-
"description": "
|
|
1577
|
+
"title": "Violet",
|
|
1578
|
+
"description": "A purple preset with large, soft corners.",
|
|
1579
1579
|
"cssVars": {
|
|
1580
1580
|
"light": {
|
|
1581
1581
|
"radius": "0.875rem",
|
|
@@ -1681,8 +1681,8 @@ var THEME_PRESETS_DATA = [
|
|
|
1681
1681
|
},
|
|
1682
1682
|
{
|
|
1683
1683
|
"id": "rose",
|
|
1684
|
-
"title": "
|
|
1685
|
-
"description": "
|
|
1684
|
+
"title": "Rose",
|
|
1685
|
+
"description": "A magenta-to-pink preset in muted tones that don't read as the destructive red, with large corners.",
|
|
1686
1686
|
"cssVars": {
|
|
1687
1687
|
"light": {
|
|
1688
1688
|
"radius": "1rem",
|
|
@@ -1788,8 +1788,8 @@ var THEME_PRESETS_DATA = [
|
|
|
1788
1788
|
},
|
|
1789
1789
|
{
|
|
1790
1790
|
"id": "mono",
|
|
1791
|
-
"title": "
|
|
1792
|
-
"description": "
|
|
1791
|
+
"title": "Mono",
|
|
1792
|
+
"description": "A near-grayscale preset with muted chart colors, the smallest corners and a monospace font (the system monospace font).",
|
|
1793
1793
|
"cssVars": {
|
|
1794
1794
|
"light": {
|
|
1795
1795
|
"radius": "0.25rem",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@squadbase/vantage-template",
|
|
3
|
-
"version": "0.1.1-dev1.
|
|
3
|
+
"version": "0.1.1-dev1.6ed50bb",
|
|
4
4
|
"description": "CLI tool for initializing and customizing Squadbase Vantage projects.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"squadbase",
|
|
@@ -50,7 +50,7 @@
|
|
|
50
50
|
"@ai-sdk/openai": "2.0.122",
|
|
51
51
|
"ai": "^5.0.52"
|
|
52
52
|
},
|
|
53
|
-
"gitHead": "
|
|
53
|
+
"gitHead": "6ed50bb2d2abe199d21fa6ac2ad9923d15462d0a",
|
|
54
54
|
"scripts": {
|
|
55
55
|
"sync-base": "rsync -a --delete --exclude='node_modules' --exclude='dist' --exclude='.vantage' --exclude='*.tsbuildinfo' --exclude='*.log' template/ base-template/ && mv base-template/.gitignore base-template/_gitignore",
|
|
56
56
|
"build": "pnpm run sync-base && tsup",
|
package/base-template/DESIGN.md
DELETED
|
@@ -1,109 +0,0 @@
|
|
|
1
|
-
<!--
|
|
2
|
-
DESIGN.md — このアプリの「見た目の意図」を書くファイルです。
|
|
3
|
-
|
|
4
|
-
- 実際の色・角丸・書体の値は src/styles.css にあります。ここにはトークン名(--primary など)と
|
|
5
|
-
使い分けのルールだけを書き、色コードは書きません。
|
|
6
|
-
- エージェントはページ・スライド・コンポーネントを書く前にこのファイルを読みます。
|
|
7
|
-
会話の中での指示はこのファイルより優先されます。
|
|
8
|
-
- 「このサイトに合わせて」「色を落ち着いた感じに」と頼めば、このファイルと styles.css を
|
|
9
|
-
まとめて更新します。
|
|
10
|
-
- このファイルはあなたのものです。`vantage upgrade` が書き換えることはありません。
|
|
11
|
-
-->
|
|
12
|
-
|
|
13
|
-
# デザイン
|
|
14
|
-
|
|
15
|
-
## 全体のトーン (Overview)
|
|
16
|
-
|
|
17
|
-
- 落ち着いた無彩色のベースに、データだけが色を持つ業務ダッシュボード。
|
|
18
|
-
- 装飾より読みやすさを優先する。影・グラデーション・アニメーションは最小限。
|
|
19
|
-
- 数字が主役。1 画面で伝えたいことを 1 つに絞り、補足は小さく添える。
|
|
20
|
-
- ブランド素材: なし(ロゴを使う場合は `public/brand/logo.svg` のように `public/` 配下のパスで書く)
|
|
21
|
-
|
|
22
|
-
## 色 (Colors)
|
|
23
|
-
|
|
24
|
-
色は必ずトークン(Tailwind のセマンティッククラス)で指定する。素のパレット(`bg-blue-600` など)や
|
|
25
|
-
色コードを直接書かない。
|
|
26
|
-
|
|
27
|
-
| 役割 | トークン | 使う場所 |
|
|
28
|
-
| --- | --- | --- |
|
|
29
|
-
| 主色 (Primary) | `--primary` / `--primary-foreground` | 主要ボタン、選択中の状態。既定(テーマ `neutral`)は青 |
|
|
30
|
-
| 強調 (Accent) | `--chart-1` | 1 つだけ目立たせたい数値・系列・リンク的な強調 |
|
|
31
|
-
| 良い (Positive) | `--chart-2` | 前期比のプラスなど、良い変化の小さな印 |
|
|
32
|
-
| 悪い (Negative) | `--destructive` | 前期比のマイナス、エラー、削除操作 |
|
|
33
|
-
| 注意 (Warning) | 専用トークンなし | 文言とアイコンで示し、色は `--muted-foreground` |
|
|
34
|
-
| 背景の段階 | `--background` → `--card` → `--muted` | ページ → カード → カード内の区画・ホバー |
|
|
35
|
-
| 境界 | `--border` / `--input` / `--ring` | 罫線、入力欄、フォーカス |
|
|
36
|
-
| 文字 | `--foreground` / `--muted-foreground` | 本文 / 補足・ラベル・単位 |
|
|
37
|
-
|
|
38
|
-
- `--muted`・`--accent`・`--secondary`・`--border` は背景・境界用。文字色に使わない。
|
|
39
|
-
- 増減(▲▼・前期比)は向きで色を分ける: 増加・プラスは `--chart-2`(または `--primary`)、
|
|
40
|
-
減少・マイナスは `--destructive`。下向きの矢印やマイナスを `--primary` で塗らない。
|
|
41
|
-
- ライトとダークの両方がトークンで決まるので `dark:` を並べない。
|
|
42
|
-
|
|
43
|
-
## チャート (Charts)
|
|
44
|
-
|
|
45
|
-
- 系列の順番は `--chart-1` → `--chart-2` → `--chart-3` → `--chart-4` → `--chart-5`
|
|
46
|
-
(現在はテーマ `neutral`: 青 → 黄緑 → 赤紫 → ティール → 紫)。
|
|
47
|
-
- 1 系列だけを目立たせるときは、その系列を `--chart-1`、残りをすべて `--chart-5` にする。
|
|
48
|
-
- 良い / 悪いを色で塗り分けるときは `--chart-2` / `--destructive`。色だけに頼らず ▲▼ や符号も添える。
|
|
49
|
-
- 系列は 5 つまで。それ以上はグループ化するか「その他」にまとめる。
|
|
50
|
-
- 禁止: 同じチャートで `--destructive` を普通の系列色として使う(悪い値に見える)。
|
|
51
|
-
- 禁止: 隣り合う系列に `--chart-3` と `--chart-4` を並べて細い線で描く(見分けにくい)。
|
|
52
|
-
- 配色を丸ごと変えるときは `npx @squadbase/vantage-template theme <id>` を使う
|
|
53
|
-
(`neutral` / `ocean` / `forest` / `sunset` / `violet` / `rose` / `mono`)。チャートだけ別の配色にするときは
|
|
54
|
-
`chart <preset>`(`blue` / `ocean` / `sunset` / `forest` / `berry` / `mono`)。
|
|
55
|
-
|
|
56
|
-
## 書体 (Typography)
|
|
57
|
-
|
|
58
|
-
| 用途 | 指定 | 備考 |
|
|
59
|
-
| --- | --- | --- |
|
|
60
|
-
| 見出し・本文 | 日本語を含むシステムフォント(`--font-sans`) | Web フォントは使わない |
|
|
61
|
-
| 数字 | 同上 + `tabular-nums` | 桁がそろうように必ず付ける |
|
|
62
|
-
| スライドの見出し | `--slide-font-display` | 既定は日本語を含むシステムフォント |
|
|
63
|
-
| スライドの本文 | `--slide-font-body` | 既定は見出しと同じ |
|
|
64
|
-
|
|
65
|
-
サイズの段階(ダッシュボード):
|
|
66
|
-
|
|
67
|
-
- ページ見出し: `text-2xl font-bold`
|
|
68
|
-
- カード見出し・ラベル: `text-sm font-medium text-muted-foreground`
|
|
69
|
-
- KPI の数値: `text-3xl font-semibold tabular-nums`
|
|
70
|
-
- 本文・表: `text-sm`
|
|
71
|
-
- 注釈・出典: `text-xs text-muted-foreground`
|
|
72
|
-
|
|
73
|
-
スライドのサイズは `--slide-size-hero`(表紙・大きな数字)と `--slide-size-body`(本文)を基準にする。
|
|
74
|
-
|
|
75
|
-
## レイアウトと密度 (Layout)
|
|
76
|
-
|
|
77
|
-
- 情報はカード(`bg-card` + `border-border`)で区切る。角丸は `--radius` に従う(個別に変えない)。
|
|
78
|
-
- グリッドの間隔は `gap-4`。セクション間は `gap-6` 程度。
|
|
79
|
-
- KPI は 1 行に 2〜4 枚。その下にチャート、最後に明細の表。
|
|
80
|
-
- 密度は「中」。余白を削って詰め込むより、ページを分ける。
|
|
81
|
-
|
|
82
|
-
## 成果物の種類ごとの規則 (Per-artifact)
|
|
83
|
-
|
|
84
|
-
### ダッシュボード
|
|
85
|
-
|
|
86
|
-
- 先頭に KPI カード、次にトレンドのチャート、最後に明細の表。
|
|
87
|
-
- 各 KPI には比較対象(前月比・目標比など)を 1 つ添える。
|
|
88
|
-
- チャートのタイトルは結論を書く(「売上推移」より「売上は 3 か月連続で増加」)。
|
|
89
|
-
|
|
90
|
-
### スライド
|
|
91
|
-
|
|
92
|
-
- 1 枚に 1 メッセージ。見出しに結論を書く。
|
|
93
|
-
- 色は `--slide-bg` / `--slide-fg` / `--slide-accent` / `--slide-muted` を使う
|
|
94
|
-
(既定では `--background` / `--foreground` / `--primary` / `--muted-foreground` に連動)。
|
|
95
|
-
- 強調色は 1 枚につき 1 か所まで。
|
|
96
|
-
|
|
97
|
-
## Do / Don't
|
|
98
|
-
|
|
99
|
-
Do:
|
|
100
|
-
|
|
101
|
-
- トークンと Tailwind のセマンティッククラスで色を指定する。
|
|
102
|
-
- 数値には単位と比較対象を付ける。
|
|
103
|
-
- 色の意味(良い / 悪い / 強調)をアプリ全体でそろえる。
|
|
104
|
-
|
|
105
|
-
Don't:
|
|
106
|
-
|
|
107
|
-
- 色コードや素のパレットクラスを直接書く。
|
|
108
|
-
- 1 画面で強調色を何か所にも使う。
|
|
109
|
-
- 3D チャート・円グラフの多用・装飾目的のグラデーション。
|