Page cover

Nest

@adminjs/nestjs

Example repository with AdminJS v7 working with NestJS & ESM: https://github.com/dziraf/adminjs-v7-with-nestjs

Make sure you have installed AdminJS packages described in Getting started article.

$ yarn add adminjs @adminjs/nestjs

As of version 5.x.x of @adminjs/nestjs, the plugin only supports Nest servers that use Express. Fastify Nest servers are not currently supported.

If you are starting a new project, install nest-cli and bootstrap the project:

$ npm i -g @nestjs/cli
$ nest new

@adminjs/nestjs uses @adminjs/express to set up AdminJS, because of this you have to additionally install it's dependencies:

$ yarn add @adminjs/express express-session express-formidable

Set moduleResolution to nodenext or node16 in your tsconfig.json:

{
  "compilerOptions": {
    "moduleResolution": "node16",
    "module": "commonjs",
    "target": "esnext",
    // ...
  }
}

Next, add Nest plugin code into imports of your AppModule:

app.module.ts
import { Module } from '@nestjs/common'

import { AppController } from './app.controller'
import { AppService } from './app.service'

const DEFAULT_ADMIN = {
  email: '[email protected]',
  password: 'password',
}

const authenticate = async (email: string, password: string) => {
  if (email === DEFAULT_ADMIN.email && password === DEFAULT_ADMIN.password) {
    return Promise.resolve(DEFAULT_ADMIN)
  }
  return null
}

@Module({
  imports: [
    // AdminJS version 7 is ESM-only. In order to import it, you have to use dynamic imports.
    import('@adminjs/nestjs').then(({ AdminModule }) => AdminModule.createAdminAsync({
      useFactory: () => ({
        adminJsOptions: {
          rootPath: '/admin',
          resources: [],
        },
        auth: {
          authenticate,
          cookieName: 'adminjs',
          cookiePassword: 'secret'
        },
        sessionOptions: {
          resave: true,
          saveUninitialized: true,
          secret: 'secret'
        },
      }),
    })),
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

Now you should be able to start your AdminJS application:

$ nest start

AdminJS panel will be available under http://localhost:3000/admin if you have followed this example thoroughly.

How to remove authentication?

If you don't want your admin panel to require authentication, simply follow the example above, but remove auth and sessionOptions configuration, for example:

import('@adminjs/nestjs').then(({ AdminModule }) => AdminModule.createAdminAsync({
  useFactory: () => ({
    adminJsOptions: {
      rootPath: '/admin',
      resources: [],
    },
  }),
})),

Using AdminJS ESM packages

Since AdminJS version 7 and it's compatible packages are ESM-only, you cannot import them directly into your CommonJS Nest app. Instead, you have to use dynamic imports:

const adminjsUploadFeature = await import('@adminjs/upload');

Last updated