3.9 KiB

Add a New Deno Project

Supported Features

Because we are using an Nx plugin for Deno, all the features of Nx are available.

{% pill url="/core-features/run-tasks" %} Run Tasks{% /pill %} {% pill url="/core-features/cache-task-results" %} Cache Task Results{% /pill %} {% pill url="/core-features/remote-cache" %} Share Your Cache{% /pill %} {% pill url="/core-features/explore-graph" %} Explore the Graph{% /pill %} {% pill url="/core-features/distribute-task-execution" %} Distribute Task Execution{% /pill %} {% pill url="/core-features/integrate-with-editors" %} Integrate with Editors{% /pill %} {% pill url="/core-features/automate-updating-dependencies" %} Automate Updating Nx{% /pill %} {% pill url="/core-features/enforce-module-boundaries" %} Enforce Module Boundaries{% /pill %} {% pill url="/core-features/plugin-features/use-task-executors" %} Use Task Executors{% /pill %} {% pill url="/core-features/plugin-features/use-code-generators" %} Use Code Generators{% /pill %} {% pill url="/core-features/automate-updating-dependencies" %} Automate Updating Framework Dependencies{% /pill %}

Install the Deno Plugin

{% callout type="warning" title="Have Deno already installed?" %} Make sure you have Deno installed on your machine. Consult the Deno docs for more details {% /callout %}

{% tabs %} {%tab label="npm"%}

npm i --save-dev @nx/deno

{% /tab %} {%tab label="yarn"%}

yarn add --dev @nx/deno

{% /tab %} {% /tabs %}

Create an Application

{% callout type="note" title="Directory Flag Behavior Changes" %} The command below uses the as-provided directory flag behavior, which is the default in Nx 16.8.0. If you're on an earlier version of Nx or using the derived option, omit the --directory flag. See the as-provided vs. derived documentation for more details. {% /callout %}

Use the app generator to create a new Deno app.

nx g @nx/deno:app deno-app --directory=apps/deno-app

Serve the API by running

nx serve deno-app

This starts the application on localhost:4200 by default.

Create a Library

{% callout type="note" title="Directory Flag Behavior Changes" %} The command below uses the as-provided directory flag behavior, which is the default in Nx 16.8.0. If you're on an earlier version of Nx or using the derived option, omit the --directory flag. See the as-provided vs. derived documentation for more details. {% /callout %}

To create a new library, run:

nx g @nx/deno:lib my-lib --directory=libs/my-lib

{% callout type="note" title="Deno Library Paths" %} Deno library paths are maintained in the root import_map.json file. Because typescript doesn't understand how to parse this file, you may get errors in your code editor that are not problems during build or serve. {% /callout %}

Once the library is created, update the following files.

export function someFunction(): string {
  return 'some function';
}
import { someFunction } from '@my-org/my-lib';

// deno-lint-ignore require-await
export async function handler(_request: Request): Promise<Response> {
  const message = JSON.stringify({
    message: 'Hello deno-app ' + someFunction(),
  });
  return new Response(message, {
    status: 200,
    headers: {
      'content-type': 'application/json',
    },
  });
}

Now when you serve your app, you'll see the content from the library being displayed.

More Documentation

{% cards cols="2" %} {% card title="Converting an Express API To Deno" type="video" url="https://youtu.be/Um8xXR54upQ" /%} {% /cards %}