> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insforge.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# React

> 了解如何创建 InsForge 项目并使用 AI 构建 React 应用程序

了解如何创建 InsForge 项目并使用 AI 工具（如 Cursor）构建 React 应用程序。

## 1. 创建 InsForge 项目

在 [insforge.dev](https://insforge.dev) 创建新的 InsForge 项目。

## 2. 连接 InsForge

两个部分：

* **CLI 链接** — 查看[快速开始](/quickstart)以运行 `npx @insforge/cli link --project-id <your-project-id>` 以便代理可以读取您的项目 ID 和密钥。
* **MCP 设置** — 查看 [MCP 设置](/mcp-setup) 以了解每个编辑器的配置（Cursor、Claude Code、Windsurf、Codex、VS Code）。

配置好两者后，代理可以读取模式、运行查询和从您的编辑器部署代码。

## 3. 通过一个提示构建您的应用

在 Cursor 或您的 AI 助手中，使用此提示：

```
Create a new React app with TypeScript and Vite.
Add Tailwind CSS 3.4 for styling.
Install the InsForge SDK and set up the client configuration.

In my InsForge database, create a sports table with id and name columns.
Add sample data: basketball, soccer, and tennis. Make it publicly readable.

Create a component that fetches and displays all sports from the database.
```

您的 AI 将生成完整的应用程序，包括数据库设置和 UI。无需手动编写代码 - AI 为您创建所有内容。

## 4. AI 生成的内容

您的 AI 助手将自动创建这样的文件。您无需手动触摸它们。

**InsForge 客户端** 在 `src/lib/insforge.ts`:

```typescript src/lib/insforge.ts theme={null}
import { createClient } from '@insforge/sdk';

export const insforge = createClient({
  baseUrl: 'https://your-project.us-east.insforge.app',
  anonKey: 'your-anon-key',
});
```

**运动组件** 在 `src/components/Sports.tsx`:

```typescript src/components/Sports.tsx theme={null}
import { useEffect, useState } from 'react';
import { insforge } from '../lib/insforge';

interface Sport {
  id: string;
  name: string;
}

export function Sports() {
  const [sports, setSports] = useState<Sport[]>([]);
  const [error, setError] = useState<string | null>(null);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    async function fetchSports() {
      const { data, error } = await insforge.database
        .from('sports')
        .select();

      if (error) {
        setError(error.message);
      } else {
        setSports(data || []);
      }
      setLoading(false);
    }

    fetchSports();
  }, []);

  if (loading) {
    return (
      <div className="min-h-screen flex items-center justify-center">
        <p className="text-gray-600">Loading...</p>
      </div>
    );
  }

  if (error) {
    return (
      <div className="min-h-screen flex items-center justify-center">
        <div className="text-red-600">
          <h1 className="text-2xl font-bold mb-2">Error</h1>
          <p>{error}</p>
        </div>
      </div>
    );
  }

  return (
    <div className="min-h-screen p-8">
      <div className="max-w-4xl mx-auto">
        <h1 className="text-4xl font-bold mb-8">Sports</h1>

        {sports.length > 0 ? (
          <div className="grid gap-4 md:grid-cols-2 lg:grid-cols-3">
            {sports.map((sport) => (
              <div
                key={sport.id}
                className="p-6 bg-white rounded-lg shadow-md border border-gray-200 hover:shadow-lg transition-shadow"
              >
                <h2 className="text-xl font-semibold text-gray-800 capitalize">
                  {sport.name}
                </h2>
                <p className="text-sm text-gray-500 mt-2">ID: {sport.id}</p>
              </div>
            ))}
          </div>
        ) : (
          <p className="text-gray-600">No sports found.</p>
        )}
      </div>
    </div>
  );
}
```

## 5. 启动应用

运行开发服务器，在浏览器中访问 [http://localhost:5173](http://localhost:5173)，您应该看到运动列表。

```bash theme={null}
npm run dev
```

## 接下来：使用更多提示扩展您的应用

尝试这些提示为您的应用添加更多功能：

```
Add a form to create new sports and save them to the database.
Include validation and error handling.
```

```
Add user authentication with sign up and login pages.
Only allow authenticated users to add new sports.
```

```
Add a favorites feature where users can mark their favorite sports.
Store favorites in a user_favorites table with user_id and sport_id.
```

```
Add images to each sport using InsForge Storage.
Allow users to upload sport images and display them in the grid.
```

```
Add an AI chat feature that can answer questions about sports.
Use InsForge AI with streaming responses.
```