kohlerm / nextjs

Next.js

In this example we will be deploying a simple "Hello World" example with Next.js.

Getting started with Next.js

• Create a pages folder with an index.js file with the following code:

import Link from "next/link";
import Header from "../components/header";

export default () => (
  <main>
    <Header />
    <section>
      <Link href="/about">
        <a>Go to About Me</a>
      </Link>
    </section>
  </main>
);

• Now lets create an about.js file inside the pages folder with the following code:

import { Component } from "react";
import Link from "next/link";
import Header from "../components/header";

class AboutPage extends Component {
  static getInitialProps() {
    const isServer = typeof window === "undefined";
    return { isServer };
  }

  render() {
    return (
      <main>
        <Header />
        <section>
          <p>
            This is another page of the SSR example, you accessed it{" "}
            <strong>{this.props.isServer ? "server" : "client"} side</strong>.
          </p>
          <p>
            You can reload to see how the page change.
          </p>
          <Link href="/">
            <a>Go to Home</a>
          </Link>
        </section>
      </main>
    );
  }
}

export default AboutPage;

• As you might noticed we have a component that is shared by both index.js and about.js files, let's create that one now. Create a folder named components with a file named header.js in it and add the following code:

export default () => (
  <header>
    <h1>Next.js Example</h1>
  </header>
);

• Finally in order for Next.js to be deployed we could either have a next.config.js or a package.json, for this example we are just going to create a next.config.js with the following code:

module.exports = {
  target: 'serverless'
}

Deploy with Now

First we need to create a now.json configuration file to instruct Now how to build the project.

For this example we will be using our newest version Now 2.0.

By adding the version key to the now.json file, we can specify which Now Platform version to use.

We also need to define each builders we would like to use. Builders are modules that take a deployment's source and return an output, consisting of either static files or dynamic Lambdas.

In this case we are going to use @now/next to build and deploy our Next.js application selecting the next.config.js as our entry point. We will also define a name for our project (optional).

{
    "version": 2,
    "name": "nextjs",
    "builds": [
        { "src": "next.config.js", "use": "@now/next" }
    ]
}

Visit our documentation for more information on the now.json configuration file.

We are now ready to deploy the app.

now