jackquinlan/blueprint

A modern Next.js 13 application blueprint.

Blueprint

• Blueprint is a Next.js starter kit built to help you get your project off the ground faster so you can focus less on the tedious setup and more on building incredible experiences for your users.

• Blueprint aims to provide a minimal set of feautures and examples that you can use to expand into your own projects and customize to fit your needs.

• This project is inspired by shadcn's Taxonomy project (https://tx.shadcn.com/).

• Check out shadcn on twitter https://twitter.com/shadcn

• I would also like to thank Theo (https://twitter.com/t3dotgg) and the T3 community (https://create.t3.gg/) for their amazing open-source work. They have all motivated and inspired me to start building!

Getting Started

1. Install dependencies by running pnpm install.
   • If you do not have pnpm installed, follow the directions here: https://pnpm.io/installation.
2. Setup the database
   • cd packages/db - Go to the database package.
   • cp .env.example .env - Copy the environment.
     • Follow the instructions in the .env file to setup a database with PlanetScale or Docker.
3. Setup the website
   • cd apps/web - Go to the Next.js website app.
   • cp .env.example .env - Copy the environment.
     • Follow the instructions in the .env file to setup all of the required environment variables.
4. To run the website, run pnpm dev and visit http://localhost:3000/

Technology Stack

• These are the technologies that are used and recommended for this starter kit. But I understand that not everyone uses everything in this list. The code is yours for you to customize. For example, switching out Next Auth for Clerk.

1. Next.js 13 + React 18
   • https://nextjs.org/docs
   • https://nextjs.org/learn
   • https://react.dev/
2. Shadcn UI Components
   • https://ui.shadcn.com/
3. tRPC
   • https://trpc.io/docs
4. Next Auth (Auth.js)
   • https://next-auth.js.org/
5. Prisma
   • https://www.prisma.io/docs
6. PlanetScale (recommended)
   • https://planetscale.com/
   • https://planetscale.com/docs/prisma/prisma-quickstart
7. Stripe
   • https://stripe.com/docs

blueprint's Issues

Enhange Profile Settings + Email/PasswordAuth

Hey @jackquinlan, very nice project and great choice of your stack.

I just had a look around, and I was thinking of two additions:

Profile Settings: Delete My account
Auth: Email/password option for login

What's the best way to install new Shadcn/UI components?

Error: Installing popover...Command failed with exit code 1: pnpm add @radix-ui/react-popover
 ERR_PNPM_ADDING_TO_ROOT  Running this command will add the dependency to the workspace root, which might not be what you want - if you really meant it, make it explicit by running this command again with the -w flag (or --workspace-root). If you don't want to see this warning anymore, you may set the ignore-workspace-root-check setting to true.
 ERROR  Command failed with exit code 1: shadcn-ui add popover
 

 

is tRPC really needed?

I did a little of experimentation with removing tRPC and relying on React Server Components for this project and it works just fine. I'm curious to know if there is something that tRPC provides that I'm missing.

Application error: a server-side exception has occurred (see the server logs for more information). Digest: 1199119462

Hey, been using this start-kit for my site and it's been great, but I just recently noticed both BluePrint and my site are sharing the same error message.

Application error: a server-side exception has occurred (see the server logs for more information).
Digest: 1199119462

Console reads:

Application error: a server-side exception has occurred (see the server logs for more information).
Digest: 1199119462

Any ideas why this error is happening now after 30 days of steady deployment? Changes to 3rd party API's?

Thank you!