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
Что это такое?Это демонстрационное приложение с открытым кодом, показывающее, как собирается современный продукт — с авторизацией, подписками, документацией и блогом — на новом app router и серверных компонентах Next.js 13.
Это библиотека, которую я устанавливаю, или готовое приложение?Полноценное приложение, которое вы запускаете и изучаете, а не пакет, который добавляют в проект: одна кодовая база на TypeScript с маркетинговыми страницами, документацией, блогом, авторизацией и подписками через Stripe.
Как запустить его у себя локально?Склонируйте репозиторий, выполните pnpm install, скопируйте .env.example в .env.local и заполните переменные, затем запустите dev-сервер — скрипт dev запускает Contentlayer и Next.js вместе.
Какие внешние сервисы нужны для работы?База данных PlanetScale MySQL за Prisma, NextAuth.js для входа и Stripe для подписок; Radix UI, Tailwind CSS, Zod и MDX уже входят в сам репозиторий.
Могу ли я использовать это как основу для нового проекта прямо сейчас?Не стоит — проект официально архивирован и больше не обновляется. В README предупреждают, что код написан до выхода стабильного App Router, может использовать устаревшие API и не рекомендуется для продакшена.
Что именно демонстрирует этот код?Маршрутизацию App Router, вложенные макеты и группы макетов, серверные и клиентские компоненты, загрузку и кэширование данных, route handlers и API-маршруты с middleware, а также документацию и блог на MDX, построенные на Contentlayer. Интерфейс собран из компонентов Radix со стилями Tailwind, валидация на Zod, есть тёмная тема.
Почему автор сделал это только на Next.js?В качестве эксперимента — посмотреть, на что способен чистый Next.js; tRPC и Turborepo сознательно не использовали, но автор не против добавить их позже.
Известно ли, что в демо не работает?Осталась одна известная проблема: opengraph-image.tsx нельзя использовать внутри catch-all маршрутов. Более ранние неполадки — например, авторизация через GitHub и ошибка в схеме Prisma — уже исправлены.
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
3y
Commits · 90 Days