|
| 1 | +# Create T3 App |
| 2 | + |
| 3 | +This is an app bootstrapped according to the [init.tips](https://init.tips) stack, also known as the T3-Stack. |
| 4 | + |
| 5 | +## Why are there `.js` files in here? |
| 6 | + |
| 7 | +As per [T3-Axiom #3](https://github.com/t3-oss/create-t3-app/tree/next#3-typesafety-isnt-optional), we take typesafety as a first class citizen. Unfortunately, not all frameworks and plugins support TypeScript which means some of the configuration files have to be `.js` files. |
| 8 | + |
| 9 | +We try to emphasize that these files are javascript for a reason, by explicitly declaring its type (`cjs` or `mjs`) depending on what's supported by the library it is used by. Also, all the `js` files in this project are still typechecked using a `@ts-check` comment at the top. |
| 10 | + |
| 11 | +## What's next? How do I make an app with this? |
| 12 | + |
| 13 | +We try to keep this project as simple as possible, so you can start with the most basic configuration and then move on to more advanced configuration. |
| 14 | + |
| 15 | +If you are not familiar with the different technologies used in this project, please refer to the respective docs. If you still are in the wind, please join our [Discord](https://t3.gg/discord) and ask for help. |
| 16 | + |
| 17 | +- [Next-Auth.js](https://next-auth.js.org) |
| 18 | +- [Prisma](https://prisma.io) |
| 19 | +- [TailwindCSS](https://tailwindcss.com) |
| 20 | +- [tRPC](https://trpc.io) |
| 21 | + |
| 22 | +Also checkout these awesome tutorials on `create-t3-app`. |
| 23 | + |
| 24 | +- [Build a Blog With the T3 Stack - tRPC, TypeScript, Next.js, Prisma & Zod](https://www.youtube.com/watch?v=syEWlxVFUrY) |
| 25 | +- [Build a Live Chat Application with the T3 Stack - TypeScript, Tailwind, tRPC](https://www.youtube.com/watch?v=dXRRY37MPuk) |
| 26 | +- [Build a full stack app with create-t3-app](https://www.nexxel.dev/blog/ct3a-guestbook) |
| 27 | +- [A first look at create-t3-app](https://dev.to/ajcwebdev/a-first-look-at-create-t3-app-1i8f) |
| 28 | + |
| 29 | +## How do I deploy this? |
| 30 | + |
| 31 | +### Vercel |
| 32 | + |
| 33 | +We recommend deploying to [Vercel](https://vercel.com/?utm_source=t3-oss&utm_campaign=oss). It makes it super easy to deploy NextJs apps. |
| 34 | + |
| 35 | +- Push your code to a GitHub repository. |
| 36 | +- Go to [Vercel](https://vercel.com/?utm_source=t3-oss&utm_campaign=oss) and sign up with GitHub. |
| 37 | +- Create a Project and import the repository you pushed your code to. |
| 38 | +- Add your environment variables. |
| 39 | +- Click **Deploy** |
| 40 | +- Now whenever you push a change to your repository, Vercel will automatically redeploy your website! |
| 41 | + |
| 42 | +### Docker |
| 43 | + |
| 44 | +You can also dockerize this stack and deploy a container. See the [Docker deployment page](https://create-t3-app-nu.vercel.app/en/deployment/docker) for details. |
| 45 | + |
| 46 | +## Useful resources |
| 47 | + |
| 48 | +Here are some resources that we commonly refer to: |
| 49 | + |
| 50 | +- [Protecting routes with Next-Auth.js](https://next-auth.js.org/configuration/nextjs#unstable_getserversession) |
0 commit comments