|
| 1 | +# TypeScript Next.js example |
| 2 | + |
| 3 | +This is a really simple project that shows the usage of Next.js with TypeScript. |
| 4 | + |
| 5 | +## Deploy your own |
| 6 | + |
| 7 | +Deploy the example using [Vercel](https://vercel.com?utm_source=github&utm_medium=readme&utm_campaign=next-example): |
| 8 | + |
| 9 | +[](https://vercel.com/new/git/external?repository-url=https://github.com/vercel/next.js/tree/canary/examples/with-typescript&project-name=with-typescript&repository-name=with-typescript) |
| 10 | + |
| 11 | +## How to use it? |
| 12 | + |
| 13 | +Execute [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app) with |
| 14 | +[npm](https://docs.npmjs.com/cli/init) or [Yarn](https://yarnpkg.com/lang/en/docs/cli/create/) to bootstrap the example: |
| 15 | + |
| 16 | +```bash |
| 17 | +npx create-next-app --example with-typescript with-typescript-app |
| 18 | +# or |
| 19 | +yarn create next-app --example with-typescript with-typescript-app |
| 20 | +``` |
| 21 | + |
| 22 | +Deploy it to the cloud with |
| 23 | +[Vercel](https://vercel.com/new?utm_source=github&utm_medium=readme&utm_campaign=next-example) |
| 24 | +([Documentation](https://nextjs.org/docs/deployment)). |
| 25 | + |
| 26 | +## Notes |
| 27 | + |
| 28 | +This example shows how to integrate the TypeScript type system into Next.js. Since TypeScript is supported out of the |
| 29 | +box with Next.js, all we have to do is to install TypeScript. |
| 30 | + |
| 31 | +``` |
| 32 | +npm install --save-dev typescript |
| 33 | +``` |
| 34 | + |
| 35 | +To enable TypeScript's features, we install the type declarations for React and Node. |
| 36 | + |
| 37 | +``` |
| 38 | +npm install --save-dev @types/react @types/react-dom @types/node |
| 39 | +``` |
| 40 | + |
| 41 | +When we run `next dev` the next time, Next.js will start looking for any `.ts` or `.tsx` files in our project and builds |
| 42 | +it. It even automatically creates a `tsconfig.json` file for our project with the recommended settings. |
| 43 | + |
| 44 | +Next.js has built-in TypeScript declarations, so we'll get autocompletion for Next.js' modules straight away. |
| 45 | + |
| 46 | +A `type-check` script is also added to `package.json`, which runs TypeScript's `tsc` CLI in `noEmit` mode to run |
| 47 | +type-checking separately. You can then include this, for example, in your `test` scripts. |
0 commit comments