Add a New Fastify Project

Supported Features

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

✅ Run Tasks ✅ Cache Task Results ✅ Share Your Cache ✅ Explore the Graph ✅ Distribute Task Execution ✅ Integrate with Editors ✅ Automate Updating Nx ✅ Enforce Module Boundaries ✅ Use Task Executors ✅ Use Code Generators ✅ Automate Updating Framework Dependencies

Create a New Workspace with a Fastify App

If you're starting from scratch, you can use a preset to get you started quickly.

npx create-nx-workspace@latest --preset=node-monorepo --framework=fastify --appName=fastify-api

Then you can skip to the Create a Library section.

If you are adding Fastify to an existing repo, continue to the next section.

Install the Node Plugin

npm i --save-dev @nx/node

Nx 15 and lower use @nrwl/ instead of @nx/

Create an Application

Use the app generator to create a new Fastify app.

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.

nx g @nx/node:app fastify-api --directory=apps/fastify-api

Nx 15 and lower use @nrwl/ instead of @nx/

Serve the API by running

nx serve fastify-api

This starts the application on localhost:3000/api by default.

Create a Library

To create a new library, run:

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.

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

Nx 15 and lower use @nrwl/ instead of @nx/

Once the library is created, update the following files.

libs/my-lib/src/lib/my-lib.ts
1export function someFunction(): string { 2 return 'some function'; 3} 4
apps/fastify-app/src/app/routes/root.ts
1import { someFunction } from '@my-org/my-lib'; 2import { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify'; 3 4export default async function (fastify: FastifyInstance) { 5 fastify.get( 6 '/', 7 async function (request: FastifyRequest, reply: FastifyReply) { 8 return { message: 'Hello API ' + someFunction }; 9 } 10 ); 11} 12

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

More Documentation