taxonomy README

The project's README from github.com/shadcn-ui/taxonomy. As one markdown file: README.md.

[!NOTE] This project has been officially archived and will no longer receive updates. See the Templates directory for Next.js starters.

I started this project when the Next.js App Router was in public preview. Because the framework has since stabilized and undergone significant architectural changes, the code in this repository:

  • Does not reflect current best practices.
  • May contain deprecated APIs or patterns.
  • Is not recommended for use in production environments.

Taxonomy

An open source application built using the new router, server components and everything new in Next.js 13.

About this project

This project as an experiment to see how a modern app (with features like authentication, subscriptions, API routes, static pages for docs ...etc) would work in Next.js 13 and server components.

Features

Roadmap

Known Issues

A list of things not working right now:

  1. GitHub authentication (use email)
  2. Prisma: Error: ENOENT: no such file or directory, open '/var/task/.next/server/chunks/schema.prisma'
  3. Next.js 13: Client side navigation does not update head
  4. Cannot use opengraph-image.tsx inside catch-all routes

Why not tRPC, Turborepo or X?

I might add this later. For now, I want to see how far we can get using Next.js only.

If you have some suggestions, feel free to create an issue.

Running Locally

  1. Install dependencies using pnpm:
pnpm install
  1. Copy .env.example to .env.local and update the variables.
cp .env.example .env.local
  1. Start the development server:
pnpm dev

License

Licensed under the MIT license.

taxonomy (shadcn-ui/taxonomy)

Searching Database…

19.3K ·GitHub
这是什么?这是一个开源示例应用,展示一个现代化产品——包含登录认证、订阅、文档和博客——如何在 Next.js 13 的新版 app router 和服务器组件上搭建起来。
这是需要安装的库,还是一个完整的应用?是一个可以运行和探索的完整应用,而不是添加到项目里的包:一套 TypeScript 代码库,包含营销页面、文档、博客、登录认证和 Stripe 订阅。
我该怎么在本地把它跑起来?克隆仓库,运行 pnpm install,把 .env.example 复制为 .env.local 并填好其中的变量,然后启动开发服务器——dev 脚本会同时运行 Contentlayer 和 Next.js。
它需要哪些外部服务才能正常工作?需要一个位于 Prisma 之后的 PlanetScale MySQL 数据库,用 NextAuth.js 处理登录,用 Stripe 处理订阅;Radix UI、Tailwind CSS、Zod 和 MDX 则直接随仓库提供。
我现在能把它当作新项目的起点来用吗?基本不行——它已被官方归档,不再更新。README 提醒说,这份代码早于 App Router 稳定版发布,可能用到已废弃的 API,不建议用于生产环境。
这份代码到底演示了哪些东西?App Router 的路由、嵌套布局和布局分组、服务器组件与客户端组件、数据获取与缓存、带中间件的路由处理器和 API 路由,还有基于 Contentlayer 的 MDX 文档和博客。界面用 Radix 组件配合 Tailwind 编写样式,用 Zod 做校验,并内置深色模式。
作者为什么只用 Next.js 来构建它?这是一次实验,想看看纯 Next.js 能走多远——tRPC 和 Turborepo 被刻意排除在外,但作者不排斥以后再加进来。
这个示例有什么已知的问题吗?目前还剩一个已知问题:opengraph-image.tsx 无法在 catch-all 路由中使用。之前的一些问题,比如 GitHub 登录认证和 Prisma schema 报错,都已经解决了。
What are similar projects?chatbot, crm, saas-starter, cal.diy, open-saas, dub, shapeshift, documenso
Creator
shadcn-ui
Size
14.3 MB
Stars
19.3K
Updated
CommitApr 20
Age
4y
Commits · 90 Days