メインコンテンツへスキップ

基本的なセットアップ

NotCMSを使用するには、スキーマと認証情報を使用してクライアントを初期化する必要があります:

前提条件

クライアントを初期化する前に、以下を確認してください:
  1. スキーマの生成 - 初回は npx notcms-kit init を実行、更新は npx notcms-kit pull を実行
  2. 環境変数 - API認証情報の設定
  3. NotCMSのインストール - プロジェクトの依存関係に notcms を追加

環境変数

必須変数

環境変数の読み込み

フレームワーク別のセットアップ

Next.js App Router

Remix

SvelteKit

トラブルシューティング

よくある問題

  • プロジェクトルートに .env ファイルが存在することを確認
  • dotenv などのローダーを使用していることを確認
  • 変数名が正確に一致していることを確認
  • NOTCMS_SECRET_KEY が正しいことを確認
  • NOTCMS_WORKSPACE_ID がワークスペースと一致することを確認
  • APIキーに必要な権限があることを確認
  • npx notcms-kit pull を実行してスキーマを生成
  • インポートパスが正しいことを確認
  • スキーマファイルが正しくエクスポートされていることを確認
  • NotCMSを最新バージョンに更新
  • npx notcms-kit pull でスキーマを再生成
  • TypeScriptバージョンの互換性を確認

次のステップ

クライアントを初期化したら、以下の操作ができます:

アイテムの一覧取得

データベースから複数のアイテムをクエリ

単一アイテムの取得

IDによる個別アイテムの取得