Eleventy

This guide shows you how to deploy a Eleventy application to Edgio.

Setup requires:

An Edgio account. Sign up for free.
An Edgio property. Learn how to create a property.
Node.js. View supported versions and installation steps.
Edgio CLI.

Install the Edgio CLI

If you have not already done so, install the Edgio CLI.

Bash
npm i -g @edgio/cli@^6.0.0

Create a new Eleventy app

If you don’t already have a Eleventy app, create one by running the following:

Bash
npm install -g @11ty/eleventy

mkdir project-name
cd project-name

echo '# Page header' > README.md

You can verify your app works by running it locally with:

1eleventy --serve

Configuring your Eleventy app for Edgio

Create a package.json at the root of your project with the following:

JavaScript
{
  "name": "eleventy",
  "scripts": {
    "build": "eleventy",
    "deploy": "edgio deploy"
  }
}

Initialize your project

In the root directory of your project run edgio init:

1edgio init --edgioVersion ^6.0.0

This will automatically update your package.json and add all of the required Edgio dependencies and files to your project. These include:

The @edgio/core package - Allows you to declare routes and deploy your application on Edgio
The @edgio/prefetch package - Allows you to configure a service worker to prefetch and cache pages to improve browsing speed
edgio.config.js - A configuration file for Edgio
routes.js - A default routes file that sends all requests to Eleventy.

Configure the routes

Update routes.js at the root of your project to the following:

JavaScript
// This file was added by edgio init.
// You should commit this file to source control.

import {Router} from '@edgio/core/router';

export default new Router()
  // Create serveStatic route for each file in the folder _site with a cache-control header of 's-maxage=315360000'
  .static('_site')

Refer to the CDN-as-code guide for the full syntax of the routes.js file and how to configure it for your use case.

Run the Eleventy app locally on Edgio

Create a production build of your app by running the following in your project’s root directory:

1npm run build

Test your app with the Sites on your local machine by running the following command in your project’s root directory:

1edgio dev

Load the site http://127.0.0.1:3000

Deploying

Create a production build of your app by running the following in your project’s root directory:

1npm run build

Deploy your app to the Sites by running the following command in your project’s root directory:

1edgio deploy

Refer to the Deployments guide for more information on the deploy command and its options.