Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ozkanonur/nestjs-enlighten

laravel-ignition like error page for NestJS Framework
https://github.com/ozkanonur/nestjs-enlighten

error-handler error-monitoring error-page nestjs nestjs-framework nestjs-module

Last synced: 2 months ago
JSON representation

laravel-ignition like error page for NestJS Framework

Awesome Lists containing this project

README

        

## No longer maintained

# NestJS Enlighten



Test and Build
Automated NPM Pusher
Package Version

License

### A laravel-ignition like error page for [Nestjs Framework](https://nestjs.com/)

### About
Nest Enlighten is a module for Nest Framework. With this module, you can render friendly error pages for spesific or global endpoints that includes a lot of detailed values behind the hood. Not only that, you can share your all or spesific stack tabs to your team online. By that, you or your team can monitor your error situation much better and easier.

## Preview
### Default(Light) Theme

### Dark Theme

## Installation
### Install this package by running one of these following commands below

##### Via npm:
```bash
npm install nestjs-enlighten --save
```
##### Via yarn:
```bash
yarn add nestjs-enlighten
```

## Usage

### Constructor Options
| Option Name | Required | Type | Default |
| ------ | ------ | ------ | ------|
| disableEnlighten | false | boolean | false |
| theme | false | 'theme-light' - 'theme-dark' | 'theme-light' |

#### As Global Filter
```typescript
import { NestEnlighten } from 'nestjs-enlighten';

async function bootstrap() {
const app = await NestFactory.create(ApplicationModule);
// Enables dark theme aswell
app.useGlobalFilters(new NestEnlighten({ theme: 'theme-dark' }));
await app.listen(3000);
}
bootstrap();
```

#### Enable/Disable for spesific endpoints
```typescript
import { NestEnlighten } from 'nestjs-enlighten';

@Controller('account')
// Lets say you want to disable this module for this endpoint
@UseFilters(new NestEnlighten({ disableEnlighten: true }))
export class AccountController {

@Get('/error-test')
throwError() {
throw new BadRequestException('Example message of 400 exception');
}
}
```

## TODO
- [x] Tests
- [x] Github Actions
- [ ] Online Stack share feature
- [ ] Add solution suggestions on unexpected errors in /src/Services/Errors/State/index.ts