NX

NX is a tool for managing monorepos.

This guide shows you how to create a connector for your NX application on Layer0. Here we use Next.js for the default NX project.

Example App

Try the Nx Example App View the Code Deploy to Layer0

1. Install the Layer0 CLI and run layer0 init

In the root of your nx monorepo, run:

npm i -g @layer0/cli
layer0 init

2. Create a custom Layer0 connector

Since our Next.js app isn't located in the root of the project as the @layer0/next connector expects, we'll need to define our own custom connector. To do so:

1. Set connector: './layer0' in layer0.config.js
2. Copy the layer0 directory from the example into the root of your monorepo.

3. Update routes.js

const { Router } = require('@layer0/core/router')
const { default: NextRoutes } = require('@layer0/next/router/NextRoutes')

module.exports = new Router()
  .match('/service-worker.js', ({ serviceWorker }) => {
    return serviceWorker('.next/static/service-worker.js')
  })
  .use(new NextRoutes('apps/next-app')) // provide the path to your Next.js app relative to the root of the monorepo here

Development: Run your nx app behind Layer0

To run your Next.js app in development mode behind Layer0, run:

layer0 dev

Deploy to Layer0

To deploy your app to Layer0, run:

layer0 deploy