Plug-and-play

Drop-in module, instant CRUD routes, and elegant overrides when you need full control.

Adapter-first

TypeORM today, Sequelize-ready tomorrow—swap ORM or validators without upheaval.

Swagger-native

Entity-driven schemas with polished response envelopes for list, details, create, update, delete.

Features

Auto CRUD endpoints

Spin up list, details, create, update, delete—in a single decorator or base class.

PATCH-first updates

Modern partial updates by default (configurable to PUT).

Relations by default

Include all relations automatically; fine-tune with include/exclude patterns.

Attributes selection

All columns by default, plus include/exclude to shape payloads.

Powerful querying

Clean filtering, sorting, pagination, and keyword search with safe whitelists.

Validation built-in

Fastest-validator out of the box; swap to Joi/Zod via adapters.

Caching

Per-endpoint NodeCache with smart invalidation after writes.

Hooks everywhere

Before/after action, query, and validation—extend without forking.

Swagger enhancer

Auto envelopes for list/details/create/update/delete; entity schemas derived from metadata.

Save (upsert)

Single endpoint to create or update based on presence of an id.

Programmatic calls

Call other sections’ actions safely within hooks or services.

CSV/Excel export

One header switch away—deliver CSV or Excel without code changes.

Bulk import

Effortless data onramp with conflict policies, batching, and dry runs.

Bulk delete

Clear data at scale with safety valves and transparent reporting.

Install

One-minute setup

// users.controller.ts
import { Controller } from '@nestjs/common'
import { UseCrud, CrudControllerBase } from 'crudman-nestjs'
import { User } from './user.entity'

@UseCrud({ sections: { users: { model: User } } })
@Controller('api/users')
export class UsersController extends CrudControllerBase('users') {}

README

Supported upload types (presets)

Use these presets in uploadable or typeHint. Override MIME/ext/size per field via validators. Avatar presets also enforce image dimensions.

Type	Allowed MIME types	Extensions	Max size (MB)	Image constraints	Notes
image	jpeg, png, gif, webp, avif	.jpg,.jpeg,.png,.gif,.webp,.avif	5	—	group
image-jpg	image/jpeg	.jpg,.jpeg	5	—
image-png	image/png	.png	5	—
image-gif	image/gif	.gif	5	—
image-webp	image/webp	.webp	5	—
image-avif	image/avif	.avif	5	—
image-avatar	jpeg, png, gif, webp, avif	.jpg,.jpeg,.png,.gif,.webp,.avif	2	min 128x128, max 4096x4096, aspect ~1:1	avatars
video	video/mp4, video/webm, video/ogg	.mp4,.webm,.ogg	100	—
video-short	video/mp4, video/webm	.mp4,.webm	25	—	short clips
audio	audio/mpeg, audio/mp4, audio/aac, audio/ogg, audio/wav	.mp3,.m4a,.aac,.ogg,.wav	20	—
pdf	—	.pdf	10	—
doc	—	.pdf,.doc,.docx,.odt	10	—
spreadsheet	—	.xls,.xlsx,.csv	10	—	group
spreadsheet-csv	text/csv	.csv	5	—
spreadsheet-xls	application/vnd.ms-excel	.xls	10	—
spreadsheet-xlsx	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet	.xlsx	10	—
csv	text/csv	.csv	5	—
xml	application/xml, text/xml	.xml	2	—
html	text/html	.html,.htm	2	—
json	application/json	.json	2	—
text	text/plain, text/markdown	.txt,.md	2	—
archive	—	.zip,.tar,.gz,.rar,.7z	200	—
binary	application/octet-stream	any	50	—	raw blobs

Default storage: filename_in_field (relative key saved in the entity field). Responses include meta.baseUrls on list/details; clients can set x-file-url=full|key_only to indicate URL preference.

CRUDMan for NestJS

Why crudman?