Skip to main content
NotCMSをプロジェクトに設定し、数分でNotionからコンテンツの取得を開始しましょう。

前提条件

始める前に、以下を確認してください:
  • Node.js 18.17以上がインストールされていること
  • 少なくとも1つのデータベースを持つNotionアカウント
  • TypeScriptの基本的な知識(推奨)

ステップ1: NotCMSをインストール

ステップ2: プロジェクトを初期化

NotCMS CLIを使用してプロジェクトをセットアップ:
このコマンドは以下を実行します:
  1. 環境変数を確認
  2. notcms.config.json設定ファイルを作成

ステップ3: 環境変数を設定

.envファイルにNotCMS認証情報を追加:
認証情報はNotCMSダッシュボードから取得してください

ステップ4: スキーマを取得

NotionデータベースからTypeScript型を生成:
これにより、src/notcms/schema.tsにタイプセーフなスキーマファイルが作成されます:

ステップ5: NotCMSを使い始める

クライアントを作成してコンテンツのクエリを開始:

次は何をする?

設定

高度な設定オプションについて学ぶ

SDKリファレンス

完全なSDK APIを探索

エラーハンドリング

適切なエラー処理方法を学ぶ

Next.jsの例

完全なNext.js統合を見る

よくある問題

.envファイルがプロジェクトルートにあり、dotenvdotenvxなどのパッケージを使用して読み込んでいることを確認してください。
Notionデータベースに正しい権限があり、APIキーがアクセスできることを確認してください。
Notionデータベースに変更を加えた場合は、npx notcms-kit pullを再度実行してスキーマを再生成してください。