Back to home

Getting StartedBuilding the applicationBuilding and exporting the websiteSeeing the final productWhat's next?Resources
Exporting Static HTML From A Nextjs 10 Site main image

Exporting Static HTML From A Nextjs 10 Site

In this blog post, we're going to take the default start from NextJS 10 and export a static site that we can host in S3.

This post goes alongside a partner post on deploying static websites to S3 using the AWS TypeScript CDK if you would like to get the site up and running on your AWS account.

Getting Started

We will use the latest create-next-app deployment to get things rolling.

1 2 # from the project root directory npx create-next-app next-10-static-export

Once this runs, there will be a new folder that hosts your NextJS 10 application in next-10-static-export.

Building the application

Adjust your application's package.json file to add a new script for export:

1 2 3 4 5 6 7 8 9 10 11 { // reduced for brevity "scripts": { "dev": "next dev", "build": "next build", "start": "next start", // add this "export": "next export" } // reduced for brevity }

Building and exporting the website

Under pages/index.js I am going to make some small adjustments for the project and add a small paragraph that says This page has been updated to show how to build and export static html from a NextJS 10 project.

After making whatever adjustments you would like, run the following from your root directory:

1 2 3 4 # Build the NextJS application npm run build # Export the HTML to the `out` directory npm run export

Once you have run both commands, you'll notice that there is now a _next and out directory created.

The out directory is where next export will move the assets to.

Seeing the final product

We can now serve those assets locally to see the build in action.

If you do not have it already, I recommend globally installing Vercel's Serve package package to enable you serve the out directory. This can be done with npm i -g serve.

Now, run serve out from the root directory and you will have a URL posted to the terminal to show you where the website is being served from (generally localhost port 5000 unless busy).

Head to the website and you will see the following:

NextJS 10 Exported Site

NextJS 10 Exported Site

Congrats! You have your statically exported site.

What's next?

If you would like to see how to deploy your website to AWS S3 using the AWS TypeScript CDK, head to the partner post and continue on.

Resources

  1. Vercel's Serve package
  2. NextJS Static Export Caveats
  3. Deploying NextJS to AWS S3 Using The AWS TypeScript CDK
  4. Final, live website deployment via the deployment blog
  5. Final code

Image credit: Isi Parente

Dennis O'Keeffe

@dennisokeeffe92
  • Melbourne, Australia

Hi, I am a professional Software Engineer. Formerly of Culture Amp, UsabilityHub, Present Company and NightGuru.
I am currently working on workingoutloud.dev, Den Dribbles and LandPad .

Related articles


1,200+ PEOPLE ALREADY JOINED ❤️️

Get fresh posts + news direct to your inbox.

No spam. We only send you relevant content.