@nx/deno

@nx/deno

Deno is a JavaScript runtime that provides great tooling and hassle-free deployment.

The following guides show you how to create a new Deno project and deploy to either Deno Deploy or Netlify.

• Deno Deploy: https://nx.dev/recipes/deployment/deno-deploy
• Netlify: https://nx.dev/recipes/deployment/deno-netlify

Setup

Create a new Nx workspace if you don't already have one.

npx create-nx-workspace@latest deno-demo --preset=@nx/deno:preset

Now, you can go into the deno-demo folder and start development.

cd deno-demo
deno task start

You can also run lint, test, and build scripts for the project.

deno task lint
deno task test
deno task build

Note: Change deno-demo to any project name you want.

Existing workspaces

You can add Deno to any existing Nx workspace.

First, install the plugin:

npm install -DE @nx/deno@latest

Create a new Deno App

You can create additional Deno apps

npx nx g @nx/deno:app

You can run npx nx serve <your-Deno-app-name> and see the sample web server on htts://localhost:8000 You can also run test, lint, and build as tasks for <your-Deno-app-name>

npx nx serve <your-Deno-app-name>
npx nx test <your-Deno-app-name>
npx nx lint <your-Deno-app-name>
npx nx build <your-Deno-app-name>

Building/Bundling is an optional step in Deno so you don't have to build when using @nx/deno, but it can be useful to bundle the code into a single file for easier portability if you so need it.

Create a new Deno Library

npx nx g @nx/deno:lib

Deno libraies only come with lint/test targets to run.

npx nx test <your-Deno-library-name>
npx nx lint <your-Deno-library-name>

You can easily consume these libraries with their import aliases that are listed in the import_map.json in the root of the workspace.

Customizing

The executors have a denoConfig option that allows you to pass in a deno config. This defaults to the generated deno.json in the project root of each generated deno project. Within this file you can control various aspects of Deno, such as lint and test settings. Read more about the deno.json config file

By default this config uses the import_map.json in the root of the workspace. This file contains the import alias to your other local Deno projects that you can use across other projects.