@squadbase/vantage-template 0.1.0 → 0.1.1-dev1.2be5c44

package/README.md

@@ -19,20 +19,20 @@ Initialize a new Vantage project in the current directory. Copies the base templ
 ```bash
 npx @squadbase/vantage-template init
 npx @squadbase/vantage-template init --force                  # Overwrite existing files
-npx @squadbase/vantage-template init --skip-install           # Skip npm install
+npx @squadbase/vantage-template init --skip-install           # Skip dependency install (bun, or npm if bun is absent)
 npx @squadbase/vantage-template init --chart sunset           # Apply a chart preset during init
 ```
 
-After initialization:
+After initialization (the template ships `bun.lock` and declares `package_manager: bun` in `squadbase.yml`; `npm run` works too once dependencies are installed):
 
 ```bash
-npm run dev      # vantage dev --no-overlay — dev server + API on :5173
-npm run build    # vantage build → dist/
-npm run check    # vantage check — static diagnostics
-npm run routes   # vantage routes — page/API route map
+bun run dev      # vantage dev --no-overlay — dev server + API on :5173
+bun run build    # vantage build → dist/
+bun run check    # vantage check — static diagnostics
+bun run routes   # vantage routes — page/API route map
 ```
 
-There is no `vite.config.ts`, no `main.tsx`, and no route table: adding a file under `src/` adds a route (`src/index.tsx` → `/`, `src/sales/[id].tsx` → `/sales/:id`), and `src/_layout.tsx` builds the nav from `useRoutes()`.
+There is no `vite.config.ts`, no `main.tsx`, and no route table: adding a file under `src/` adds a route (`src/index.tsx` → `/`, `src/sales/[id].tsx` → `/sales/:id`), and `src/_layout.tsx` builds the nav from `useRoutes()`. The layout passes Vantage's `useNavigate()` to the header page selector so selecting a page updates the route without reloading the app.
 
 Since `@squadbase/vantage` v0.3.0, `src/` is the page-scan root and does not appear in URLs. `server/` and `public/` stay at the project root — `src/server/` is never scanned.
 

package/base-template/.squadbase/skills/vantage-app/SKILL.md

@@ -14,7 +14,7 @@ description: Vantage(@squadbase/vantage)ダッシュボードアプリを一か
 
 ## 全体の流れ
 
-1. **骨組み** — `pnpm dev` が上がるところまで
+1. **骨組み** — `bun run dev` が上がるところまで
 2. **ルートを決める** — ページファイルを置き、`vantage routes` で URL を確認
 3. **データを繋ぐ** — 外部 API か、自前の `server/api` か
 4. **仕上げ** — `check` → `build` → `preview`
@@ -52,7 +52,7 @@ exit 1 になる。
 ```
 
 `index.tsx` はデフォルトエクスポートの React コンポーネント 1 つ(これが `/` になる)。あとは
-`pnpm install && pnpm dev` で http://localhost:5173 が上がる。
+`bun install && bun run dev` で http://localhost:5173 が上がる(このプロジェクトの package manager は bun。`bun.lock` を持つ)。
 
 **既存アプリに合流したときは、作る前に現状を読む:**
 
@@ -105,10 +105,10 @@ vantage add skill  # 配置済みの skill(このファイルの仲間)と、そ
 ## Step 4 — 仕上げ
 
 ```bash
-pnpm check     # エラーが残っていないか(exit 1 なら残っている)
-pnpm routes    # 公開される URL の最終確認
-pnpm build     # dist/ に client(+ server)+ vantage-manifest.json
-pnpm preview   # 本番ビルドをローカルで動かす
+bun run check     # エラーが残っていないか(exit 1 なら残っている)
+bun run routes    # 公開される URL の最終確認
+bun run build     # dist/ に client(+ server)+ vantage-manifest.json
+bun run preview   # 本番ビルドをローカルで動かす
 ```
 
 `vantage-manifest.json` の `mode` は `server/` の有無から自動で決まる(手で書かない)。

package/base-template/AGENTS.md

@@ -331,3 +331,21 @@ const res = await fetch(`${baseUrl}/queries/${QUERY_ID}?since=2026-01-01`, {
 - **データ取得の失敗は各ページが `ErrorState` で出す。** `BuildRecovery` が拾うのは
   「レンダリングが throw した」場合だけで、`useApiQuery` の `isError` はページの責任
   (→ `agents/page.md` の「データ取得」)。
+
+## 依存の追加とスクリプトの実行は bun で
+
+このプロジェクトの package manager は **bun** です(`squadbase.yml` の `package_manager: bun`、
+lockfile は `bun.lock`)。Squadbase のサンドボックスは bun と依存のキャッシュを持っており、
+`bun install` はキャッシュだけで終わります。上のフレームワーク規約に出てくる
+`pnpm install` / `pnpm dev` / `pnpm check` は、そのまま `bun install` / `bun run dev` /
+`bun run check` に読み替えてください。
+
+### 追加の不変条件
+
+- **依存を足すときは `bun add <pkg>`(開発用は `bun add -d <pkg>`)。** `npm install` や
+  `pnpm add` を使わない — `package-lock.json` / `pnpm-lock.yaml` が生えて `bun.lock` と別の断面に
+  なり、次回起動時の install が lockfile を作り直す。
+- **`bun.lock` を消さない・手で編集しない。** `package.json` の依存を直接書き換えたときは
+  `bun install` を一度走らせて `bun.lock` を追従させ、両方を同じコミットに入れる。
+- スクリプトは `bun run <script>`(`bun run dev` / `bun run build` / `bun run check` /
+  `bun run routes`)。`npm run <script>` でも動くが、install に npm を使わないこと。

package/base-template/agents/doc.md

@@ -44,6 +44,8 @@ export default function JuneSummary() {
   `useApiQuery` などで読み込むと、開くたびに値が変わります。
 - **チャートは `EChart`(`@squadbase/vantage/components`)を文中に置く。** `figure` で囲めば
   `figcaption` がキャプションになります。
+- **PDF の保存ボタンは作らない。** `<Document>` が右下に PDF 保存のボタンを出し、印刷時は
+  本文だけをライトの配色で出します。
 - **ページ全体を包むのは `<Document>` だけ。** `PageShell` などのダッシュボード用の枠で包まない
   (本文の幅と余白は `<Document>` が決めます)。