> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notcms.com/llms.txt
> Use this file to discover all available pages before exploring further.
# クイックスタート
> 5分でNotCMSを始めよう
NotCMSをプロジェクトに設定し、数分でNotionからコンテンツの取得を開始しましょう。
## 前提条件
始める前に、以下を確認してください：
* Node.js 12以上がインストールされていること
* 少なくとも1つのデータベースを持つNotionアカウント
* TypeScriptの基本的な知識（推奨）
## ステップ1: NotCMSをインストール
```bash npm theme={null}
npm install notcms
```
```bash yarn theme={null}
yarn add notcms
```
```bash pnpm theme={null}
pnpm add notcms
```
```bash bun theme={null}
bun add notcms
```
## ステップ2: プロジェクトを初期化
NotCMS CLIを使用してプロジェクトをセットアップ：
```bash theme={null}
npx notcms-kit init
```
このコマンドは以下を実行します：
1. 環境変数を確認
2. `notcms.config.json`設定ファイルを作成
## ステップ3: 環境変数を設定
`.env`ファイルにNotCMS認証情報を追加：
```env theme={null}
NOTCMS_SECRET_KEY=your-secret-key
NOTCMS_WORKSPACE_ID=your-workspace-id
```
認証情報は[NotCMSダッシュボード](https://dash.notcms.com)から取得してください
## ステップ4: スキーマを取得
NotionデータベースからTypeScript型を生成：
```bash theme={null}
npx notcms-kit pull
```
これにより、`src/notcms/schema.ts`にタイプセーフなスキーマファイルが作成されます：
```typescript theme={null}
export const schema = {
blog: {
id: "abc123...",
properties: {
title: "title",
published: "checkbox",
author: "rich_text",
tags: "multi_select"
}
}
} satisfies Schema;
```
## ステップ5: NotCMSを使い始める
クライアントを作成してコンテンツのクエリを開始：
```typescript theme={null}
import { Client } from 'notcms';
import { schema } from './notcms/schema';
const nc = new Client({ schema });
// 公開されたブログ記事をすべて取得
const [posts, error] = await nc.query.blog.list();
if (error) {
console.error("記事の取得に失敗しました:", error);
} else {
posts.forEach(post => {
console.log(post.title);
});
}
```
## 次は何をする？
高度な設定オプションについて学ぶ
完全なSDK APIを探索
適切なエラー処理方法を学ぶ
完全なNext.js統合を見る
## よくある問題
`.env`ファイルがプロジェクトルートにあり、`dotenv`や`dotenvx`などのパッケージを使用して読み込んでいることを確認してください。
Notionデータベースに正しい権限があり、APIキーがアクセスできることを確認してください。
Notionデータベースに変更を加えた場合は、`npx notcms-kit pull`を再度実行してスキーマを再生成してください。