c15t 开源项目使用教程

1. 项目介绍

c15t 是一个开源的隐私同意管理解决方案，旨在将分析、同意跟踪和隐私控制统一成一个高性能的系统。该项目专为现代开发团队设计，将隐私管理从一项合规负担转变为一个完全可观测的系统。c15t 符合 GDPR、CCPA 和 LGPD 等隐私法规。

2. 项目快速启动

首先，确保您的开发环境中安装了 Node.js (版本 >= 22) 和 pnpm (版本 >= 9)。

克隆仓库

git clone https://github.com/c15t/c15t.git
cd c15t

安装依赖

pnpm install

启动开发环境

pnpm dev

运行测试

pnpm test

引入项目到您的应用

在您的 React 应用中，您可以通过以下代码使用 c15t：

import {
  ConsentManagerProvider,
  CookieBanner,
  ConsentManagerDialog
} from "@c15t/react";
import { c15tConfig } from "./c15t.client";

export default function App() {
  return (
    <ConsentManagerProvider config={c15tConfig}>
      <CookieBanner />
      <ConsentManagerDialog />
      {/* 您的应用内容 */}
    </ConsentManagerProvider>
  );
}

3. 应用案例和最佳实践

服务器端组件

c15t 支持服务器端组件，完全兼容 Next.js 应用目录结构。

隐私设计

在应用设计中，始终考虑隐私，确保符合各种隐私法规。

实时调试

利用 c15t 提供的开发者工具进行实时同意调试。

4. 典型生态项目

c15t 提供了以下包以支持不同的使用场景：

• @c15t/react：一流的 React 组件。
• @c15t/dev-tools：开发和调试工具。
• @c15t/cli：命令行界面，用于管理 c15t 实例。
• @c15t/backend：自托管 Node 实例和数据库。

通过上述内容，您应该能够快速上手并使用 c15t 项目，进一步开发和优化您的应用。