Next.js / TypeScript を簡単に始める手順

手軽に React.js を使った実験をしたいので、設定無しで使える Next.js の利用開始手順をまとめた。(https://github.com/propella/simple-next)

手順

next と依存ライブラリのインストール

npm install react react-dom next
npm install --save-dev typescript @types/react @types/node eslint

空の tsconfig.json を作る

touch tsconfig.json

pages/index.tsx を書く。パス名は決まっていて、pages/hoge.tsx のように tsx を置くと http://localhost/hoge からアクセスできる。対応する html は Next.js が自分で作る。

export default function Home() {
  return <p>Hello, World!</p>
}

package.json に起動スクリプト追加

  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "lint": "next lint"
  },

テスト実行するとおすすめの tsconfig.json が作られる。

npm run dev

tsconfig.json にエラーがあるので compilerOptions に以下を追加。またお好みで "strict": true したりする。

"moduleResolution": "node",

lint の設定

npm run lint

利用する関数によって2つのレンダリング方式を選べる。

getStaticProps: Static Generation
- ビルド時に getStaticProps を呼んでページを生成する。
- 何度アクセスしても同じ内容が返る
- 例: https://github.com/propella/simple-next/blob/pre-rendering/pages/static.tsx
getServerSideProps: Server-side Rendering
- 実行時に getServerSideProps を呼んでページを生成する。
- アクセスするたびに違う内容を返す事ができる。
- 例: https://github.com/propella/simple-next/blob/pre-rendering/pages/ssr.tsx

npm run build && npm start するとレンダリング方式の違いを確認できる。Next.js は生の React.js と違いサーバ側に Node やロードバランサ等が必須なので、Vercel のようなビジネスが成立する。

npx next build && npx next export

で生の React のように静的なアプリを生成するので、従来型の SPA を作れる。この場合 getServerSideProps のような実行時に Node サーバーが必要な機能が使われているとエラーになる。