@c15t/tanstack-start

中文文档
3.2.2发布于 2026/11/02Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 7.5万

TanStack cookie同意旗下为TanStack Start所建,由C15t所建. 服务器给的横幅,请求中间软件和一个偏好中心.

中文使用文档
文档目录11 节
  1. 关键特性
  2. 先决条件
  3. 安装
  4. 使用量
  5. 在 Inth 上运行 c15t
  6. 文档
  7. AI 代理文件
  8. 支助
  9. 捐款
  10. 警卫
  11. 许可证

c15t: the open standard for cookie banners

@c15t/tastack- start:谭斯塔克 开始饼干旗和饼干同意管理

Latest NPM Version Stars License Discord Skills Made by Inth

Cookie旗下,同意对话框,以及TanStack Start的首选中心. 根加载器中的服务器功能解决了每个访问者的同意政策,如欧盟的GDPR选入,因此横幅在第一个HTML中.

c15t用于 2 100个以上地点包括expo.dev, sed.dev, unkey.dev, mintlify.com, 和 sazabi.com.

关键特性

  • 与 @tanstack/react-start 1.168.60 或后一 1.x 发布,包括 TanStack Start 1.0, 在 React 18 或 19上
  • 根路由加载器在服务器上解决了每个访客的政策, 因此横幅在第一个 HTML 中, 不显示为晚
  • 您的政策下载时间与 consentManifest() 并留在服务器上
  • 请求中间软件读取 CDN 位置、 语言和全局隐私控制信头
  • 前置页面和静态主机也工作,使用 createConsentRoute() 对同一来源的同意请求
  • 预建 cookie 横幅、 同意对话框和优先选择中心
  • 完全定制设计的无头钩
  • 分析、广告和像素通过@c15t/整合跟踪每个访客的选择:Google Tag管理器、Google的同意模式v2、GA4、Meta像素、PostHog等
  • IAB TCF 2.4 横幅、对话框和钩子通过@c15t/resact/iab子路径
  • 通过@c15t/翻译翻译53种语文

先决条件

  • @tanstack/react-start 1.168.60 或后1.x发布,包括 TanStack Start 1.0
  • @tanstack/react-router 1.170.41 或以后的1.x发布, 在版本您的 @tanstack/react-start 释放取决于。 TanStack Start 1.0 至少需要 1.170.43 (韩语)
  • Vite 7 或后期, 或 Vite 8 或后期 TanStack Start 1.0
  • 反应 18 或 19
  • 节点.js 20.19或后期,或为TanStack Start 1.0的节点.js 22.12或后期
  • 一个 内部项目 (免费报名). 对于开发和测试,本地模式不需要后端

安装

pnpm add @c15t/tanstack-start

然后将预建的样式表添加到您的 CSS 应用程序级条目 :

/* src/styles.css */
@import "@c15t/tanstack-start/styles.css";

使用几个 C15t 包? 安装 c15t 导入 c15t/tanstack-start 换句话说 这是同一个代码.

使用量

  1. 设定 VITE_C15T_BACKEND_URL 到您的 Inth 后端 URL .env
  2. 添加 consentManifest() 从 @c15t/tanstack-start/build 改为 vite.config.ts,在 tanstackStart()它在构建时下载您的策略并保存在服务器上
// vite.config.ts
import { consentManifest } from '@c15t/tanstack-start/build';
import { tanstackStart } from '@tanstack/react-start/plugin/vite';
import viteReact from '@vitejs/plugin-react';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [consentManifest(), tanstackStart(), viteReact()],
});
  1. 在根路由加载器中解决同意状态 createConsentStateHandler() 在服务器函数中,并传递给 ConsentRoot
// src/routes/__root.tsx
import { createRootRoute, Outlet } from '@tanstack/react-router';
import { createServerFn } from '@tanstack/react-start';
import {
  ConsentBanner,
  ConsentDialog,
  ConsentDialogLink,
  ConsentRoot,
} from '@c15t/tanstack-start';
import {
  consentLoaderOptions,
  createConsentStateHandler,
} from '@c15t/tanstack-start/server';

const getConsentState = createServerFn({ method: 'GET' }).handler(
  createConsentStateHandler()
);

export const Route = createRootRoute({
  ...consentLoaderOptions,
  loader: async () => ({ consent: await getConsentState() }),
  component: RootComponent,
});

function RootComponent() {
  const { consent } = Route.useLoaderData();
  return (
    <ConsentRoot state={consent}>
      <Outlet />
      <ConsentBanner />
      <ConsentDialog />
      <ConsentDialogLink>Privacy settings</ConsentDialogLink>
    </ConsentRoot>
  );
}
  1. 关于完整的设置,见 TanStack 开始快速启动

在 Inth 上运行 c15t

c15t需要一个后端来服务政策和保存同意记录. 输入 为您运行它。 它把每个选择都储存在它的区域和政策版本中,审计你的现场,并拉动隐私风险请求,在Pro和以上上,每个地区的同意规则都有管理的政策包。 你不运行同意数据库, 地理检索, 上升时间,或升级.

注册是免费的。 运行 npx @inth/cli c15t 创建项目并设置 c15t,或用手创建并复制其后端 URL.

对于开发和测试,本地模式在浏览器中保留选择,不保存同意记录. 别把它运去生产 它的工厂 local()旧名, offline(),仍然工作,在v4离开.

文档

见 文档 用于指南、API参考和示例.

AI 代理文件

这个软件包以Markdown为载体,与已安装的版本相匹配。 安装后,请指定编码代理 node_modules/@c15t/tanstack-start/AGENTS.md它将每个向导在 node_modules/@c15t/tanstack-start/docs/。 。 。 .

在网络上,每页 c15吨文件 拥有Markdown版本,并且 页:1 全部列出 安装 c15t 代理技能 npx skills add c15t/skills。 。 。 .

支助

捐款

警卫

不为安全弱点打开一个公共问题。 私下通过报告 GitHub 的脆弱性报告我们审查所有的报告.

  • 不在公共论坛、议题或请求中分担脆弱性
  • 给它复制的步骤 和它影响的版本
  • 在你透露之前给我们点时间

许可证

Apache 许可证 2.0


由 输入

版本与发布记录

@c15t/tanstack-start 共发布 21 个版本,首次发布于 2026/09/15;过去 12 个月发布了 21 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.2.2latest2026/11/027 天前
3.2.12026/10/319 天前
3.2.02026/10/3010 天前
3.2.0-canary.0canary2026/10/2316 天前
3.1.02026/10/1723 天前
3.1.0-canary.02026/10/1525 天前

其他发布通道:alpha → 3.0.0-alpha.12,canary → 3.2.0-canary.0。

关于 @c15t/tanstack-start 的常见问题

@c15t/tanstack-start 是什么?

TanStack cookie同意旗下为TanStack Start所建,由C15t所建. 服务器给的横幅,请求中间软件和一个偏好中心.

如何安装 @c15t/tanstack-start?

在项目目录运行 npm install @c15t/tanstack-start,或使用 pnpm add / yarn add / bun add。

@c15t/tanstack-start 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@c15t/tanstack-start 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@c15t/tanstack-start 可以商用吗?

@c15t/tanstack-start 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@c15t/tanstack-start 的下载量有多少?

根据 npm 官方下载统计,@c15t/tanstack-start 在 2026/10/09 – 2026/11/07 这 30 天内被下载 75,086 次,日均约 2,503 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@c15t/tanstack-start 还在维护吗?

最新版本 3.2.2 发布于 2026/11/02(7 天前);至今共发布 21 个版本,其中过去 12 个月发布了 21 个;首次发布于 2026/09/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。