Next.jsReact启动器

venefish — Next.js 启动器模板

作者 enesien

venefish 是一个基于 Next.js App Router 的启动器模板，集成 Firebase 认证与 Firestore、shadcn/ui 和 Tailwind，面向部署到 Vercel 的 React TypeScript 项目。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

2 个预览视图

桌面端首页1 / 2

访问演示网站在新标签页打开

桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 2

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-02查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

基于 Next.js App Router 的 React TypeScript 启动器

集成 Firebase 认证与 Firestore 数据库

UI 使用 shadcn/ui 与 Tailwind

提供 Vercel 部署路径，仓库名对应 Vercel、Next.js、Firebase、shadcn

MIT 许可，可免费使用、修改、商用和分发

模板详细介绍

venefish 是 enesien 维护的 Next.js 启动器模板，采用 App Router，使用 React 与 TypeScript，UI 层由 shadcn/ui 和 Tailwind 组成，后端能力来自 Firebase 的认证与 Firestore 数据库。仓库名称本身对应 Vercel、Next.js、Firebase、shadcn 四个组成部分。

模板默认不包含 firebase/admin。README 说明，如需在服务端使用 Admin SDK，需要在项目根目录创建 .env.local，定义 FIREBASE_ADMIN_SDK 变量，把 Firebase 服务账号私钥字符串化后填入，并在 Vercel 中配置同名环境变量；仓库中的 api/test.ts 可用于把私钥转成字符串。

基础使用流程是：先在 Firebase 项目中启用认证，把公开的 Firebase 配置粘贴到 components/firebase-providers.tsx，然后执行 npm i 与 npm run dev。仓库提供在线演示站点，并附有桌面端与手机端首页截图。

Next.jsReact启动器

适合你的项目吗？

适用场景

快速搭建带 Firebase 认证的 Next.js 项目骨架
需要一个使用 shadcn/ui 与 Tailwind 的 React 起始界面
准备把 Next.js 应用部署到 Vercel 并接入 Firebase 服务
在服务端通过 FIREBASE_ADMIN_SDK 环境变量使用 Firebase Admin SDK

适合人群

熟悉 React 与 TypeScript、希望以 Next.js App Router 起步的开发者
计划使用 Firebase 认证与 Firestore 的项目
使用 shadcn/ui 和 Tailwind 作为样式方案的团队
需要 MIT 许可、可自由修改与商用的项目

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
在 Firebase 项目中启用认证，并把公开的 Firebase 配置填入 components/firebase-providers.tsx
2
执行 npm i 安装依赖，npm run dev 启动开发环境
3
如需 firebase/admin，在根目录创建 .env.local 并定义 FIREBASE_ADMIN_SDK，同时在 Vercel 配置同名环境变量
4
可用 api/test.ts 把 Firebase 服务账号私钥转成可写入环境变量的字符串
5
启用 Firebase 等外部服务前，需自行核对额度与收费，并单独确认第三方素材许可

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

使用前必须自行创建 Firebase 项目并启用认证，将公开的 Firebase 配置粘贴到 components/firebase-providers.tsx，否则模板无法运行。
如需使用 firebase/admin，必须自行获取 Firebase 服务账号私钥并字符串化后填入 FIREBASE_ADMIN_SDK 环境变量，该功能默认不包含在项目中。
部署到 Vercel 时需在平台侧配置同名 FIREBASE_ADMIN_SDK 环境变量，依赖外部平台账户与配置。
免费仅限 Vercel 与 Firebase 的低额度层级，用量增长后需按这些外部服务的收费规则付费。
README 提及 Firebase 集成；启用相关动态功能前需自行配置，并核对 Firebase 的额度与收费。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

Get your public Firebase config and paste it into `components\firebase-providers.tsx`
README 原文

Get your Firebase service account private key and stringify it then set the above variable to that string
README 原文

You need to define the same `FIREBASE_ADMIN_SDK` environment variable in Vercel
README 原文

projects can be built and deployed for free until you get to higher tiers within Vercel/Firebase which only happens once you get lots of DAUs
README 原文

https://github.com/enesien/venefish/blob/main/LICENSE https://github.com/enesien/venefish/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-02。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料较完整 · 96 / 100
技术栈: Next.js · React
网站类型: 启动器

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2026-02-19
截图检查日期: 2026-10-02

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Next.js。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: e1924d457e8f6b1fc13eb1ebf3755e66c44b37751ee1916d9c3c5a9f185529cb

2026-10-02T09:33:06.731Z

来源文件 / 仓库

# Venefish 🐟

### Boilerplate for React TypeScript projects using Next.js, shadcn/ui, Tailwind and Firebase on Vercel!

> Now using Next.js app router!

This stack is 🔥 because projects can be built and deployed for free until you get to higher tiers within Vercel/Firebase which only happens once you get lots of DAUs.

- **Ve**rcel for cloud and automated deployments
- **Ne**xt.js for better React
- **Fi**rebase for auth and database (Firestore)
- **Sh**adcn and Tailwind for UI/styling

**Let me know if you have any questions! Godspeed.**

## Setup

1. Make sure your Firebase project has authentication added
1. Get your public Firebase config and paste it into `components\firebase-providers.tsx`
1. `npm i` and `npm run dev`

The following is only needed if you want to use `firebase/admin` (not part of this project by default)

1. Create a new file at the root level called `.env.local`
1. Define a new variable there called `FIREBASE_ADMIN_SDK`
1. Get your Firebase service account private key and stringify it then set the above variable to that string
   > e.g.: `FIREBASE_ADMIN_SDK={"type":"service_account","project_id":"sleeptoken",...}`

### Notes

- You can use `api/test.ts` to stringify your private key so you can use in in the environment
- You need to define the same `FIREBASE_ADMIN_SDK` environment variable in Vercel

反馈内容错误