はじめに
ダウンロードから実行・モジュール追加・設定値・実際のバックエンド接続・デザイン・アップデートまで、最初の 1 日に必要な手順です。
価格ページで必要なエディションを PayPal で購入します。サブスクではなく買い切りです。
ヘッダーのマイアカウント → マイプロダクト。React・Vue・Next.js の zip には、エディションのフォルダと共通のモックバックエンド (initfn-mock) が並んで入っています。
initfn-react-1.0.0/
initfn-react/ # React edition
initfn-mock/ # mock backend (found at ../initfn-mock - keep both side by side)Node.js 24 (各エディションの .nvmrc を参照) と npm。Vanilla では不要です。
モックバックエンドを起動してから、アプリを起動します。admin / 1234 でログインできます。
cd initfn-mock && npm i && cd ..
cd initfn-react && npm i # initfn-vue for Vue
npm run mock # mock backend http://localhost:4000
npm run dev # React :4001 · Vue :4003 · docs at /docNext サーバー単体 (モノリス) で起動するか、モックバックエンドに接続して起動します。
cd initfn-nextjs && npm i
npm run mock # when using the mock backend
npm run dev # http://localhost:4002 · docs at /docビルド不要です。_guide の HTML ファイルをブラウザで開いて使い方とサンプルソースを確認し、自分のページから css・js・font フォルダを読み込みます。
React・Vue・Next.js エディションでは、50 個のモジュールをコマンド 1 つで追加・削除できます - 画面・API・メニューが一緒に入り、一緒に消えます。
npm run preset # list modules
npm run preset add social-login mfa # add
npm run preset remove mfa # removeReact・Vue・Next.js 版の設定値は 3 つのファイルに分けて置きます。.env は開発・本番共通 (サイト名のような秘密ではない値)、.env.development は開発だけ、.env.production は本番だけで使う値です。3 ファイルとも git には入れず、自分のパソコンだけで変えたい値は .env.local に置きます。
.env # shared, not secret - site name, public IDs
.env.development # dev only - local backend URL, sandbox keys
.env.production # production only - live URL, live keys, analytics ID
.env.local # your machine only (overrides the others)モジュールを追加すると、そのモジュールに必要な設定キーが適切なファイルの末尾に説明コメント付きで入り、最後に入力が必要なキーを知らせます。すでにある値には触れず、モジュールを外しても値は消しません。
npm run preset add paypal
# -> adds PAYPAL_* keys to .env.development
# and .env.production, then lists keys to fillバックエンドのアドレスは core/config/apiConfig.js の表 1 行と、.env.development (本番は .env.production) のアドレス 1 行だけです。画面のコードは変えません。
# .env.development (production: .env.production)
BACKEND_API_URL=http://your-backend:8080initfn-mock/openapi.yaml に、フロントエンドが期待する API が書かれています。バックエンド開発者に渡してください - このとおりに応答するバックエンドなら、コードを変えずに接続できます。
スタイルは 3 層に分かれています。色・フォント・角丸・影などの値は initfn-token.css、ボタン・入力・カード・ブロックなど小さな UI の見た目は initfn-base.css、ページ・セクションなど大きなデザインは initfn-global.css に書きます。ブランドカラーだけ変えるなら、token ファイル末尾の --color-brand-* だけを直します。
src/core/style/ # Vanilla: css/ · font/ · image/
css/initfn-token.css # values - colors, fonts, radius, shadows
css/initfn-base.css # small UI, components, blocks
css/initfn-global.css # pages and sections
font/ image/デザイン案や希望の雰囲気を渡して、版に入っているデザインスキルを読んでから変えるよう頼みます。このスキルがリクエストごとにどのファイルを直すかを決めているので、AI は画面のコードには触れずにこの 3 ファイルを直します。
.claude/skills/ssr-design/ # Next.js
.claude/skills/csr-design/ # React
.claude/skills/vue-design/ # Vue
.claude/skills/vanilla-design/ # VanillaCSS はルール 1 つを 1 行で書きます (token ファイルだけ改行)。VS Code では保存時に自動で整います。フォントは Pretendard を画面に必要な分だけ読み込むので、最初の画面のフォントは約 1MB です。React・Vue・Next.js 版では共通の Image コンポーネントを使うと、画像が遅延読み込み・avif/webp で軽く配信されます。
npm run format # tidy CSS - one rule per line
node scripts/format-css.mjs # VanillaReact・Vue・Next.js 版は、新しい zip の .preset フォルダーでプロジェクトの .preset を上書きしてから update を実行します。一覧の ⬆ は新しい版が出たインストール済みモジュール、🆕 は新しく追加されたモジュールです。自分で変更したファイルは上書きせず、横に .preset-new として置くので、比べてマージしたあと削除してください。
# 1. copy .preset from the new zip over your project's .preset
npm run preset # 2. list - ⬆ update available · 🆕 new module
npm run preset update # 3. update installed modules
npm run preset add <name> # 4. add a new module
npm run lint && npm test && npm run buildどのモジュールをどの版で入れたかは、プロジェクトのルートにある preset.lock.json に残ります。.preset フォルダーを丸ごと上書きしても記録が残るようフォルダーの外に置いているので、git にも一緒に入れてください。
core・shared などの基本コードの改善まで受け取るなら、zip から git リポジトリを作り、手を加えていないオリジナルを initfn ブランチに置いておきます。自分の作業は main で行います。
git init && git add . && git commit -m "initfn 1.0.0"
git branch initfn # untouched originalアカウントから新しい zip をダウンロードして initfn ブランチに上書きし、main にマージしたあと、npm run preset update でインストール済みモジュールもそろえます。自分で変更した箇所と重なる部分だけがコンフリクトになります。変更点はリリースノートにあります。
git switch initfn
# unzip the new version over it (keep node_modules and your .env files)
git add -A && git commit -m "initfn 1.1.0"
git switch main && git merge initfn
npm run preset update # sync installed modulesどのエディションもコマンド名は同じです。
npm run lint && npm test # rules and unit tests
npm run build # production build
npm run test:e2e # browser E2Eデプロイ方法はアプリ内の開発者ガイド (/doc) にあります。最終成果物をデプロイ・納品するときは、エディションに入っている THIRD_PARTY_NOTICES.md (オープンソースの告知) を含めてください。
詳しいガイドの全体は、プロジェクトのアーカイブに入っています。 このページでは初日に必要なことだけを扱います。それ以外 - インストール、設定、コンポーネント、モジュール、デプロイ - は、ダウンロードしたアーカイブの内蔵ガイドサイト (7 言語)、README、AI コーディングツール向けドキュメント (AGENTS.md) にあります。
FAQ とライセンスを確認するか、numerxlab@gmail.com までご連絡ください。