Question 1

How to set up authentication in Taxonomy with NextAuth.js?

Accepted Answer

Taxonomy uses NextAuth.js configured with GitHub and email providers. You need to set up environment variables for OAuth keys and database connections via Prisma. Follow the README's local setup steps using pnpm and .env files for a working example.

Question 2

Taxonomy vs Next.js official templates: which is better for learning?

Accepted Answer

Taxonomy is more comprehensive, covering full-stack features like payments and content management, while official templates focus on specific aspects. For deep dives into Next.js 13's new app router and server components, Taxonomy offers a richer, real-world context.

Question 3

What database does Taxonomy use and how to connect it?

Accepted Answer

It uses PlanetScale with Prisma ORM. You'll need a PlanetScale account, set up the database schema via Prisma migrations, and configure the connection string in .env.local. The README outlines basic steps, but full setup requires external service integration.

Question 4

Are there performance issues with the app directory in Taxonomy?

Accepted Answer

Yes, the README warns of performance hits in the dashboard due to unstable Next.js 13 releases. Server components and the new router are in beta, so expect slower loads and potential bugs, especially in data-heavy sections.

Question 5

How to add custom MDX pages for documentation in Taxonomy?

Accepted Answer

Taxonomy uses Contentlayer to process MDX files. Add new .mdx files in the content directories, and they'll be automatically rendered as pages. Check the project structure for examples and tweak Contentlayer configuration in the codebase.

Question 6

Can I use Taxonomy as a base for my SaaS project?

Accepted Answer

While it demonstrates SaaS-like features such as subscriptions, it's not production-ready due to beta dependencies. Use it as a learning reference, but for real projects, wait for stable releases or adapt cautiously, considering the known issues and setup complexity.

Taxonomy

What is Taxonomy?

Overview

Use Cases

Best For

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions