Vonome Builder for NestJS

The Ultimate Dynamic Page Builder Backend library for Multi-Tenant SaaS & Enterprise Applications.

Vonome Builder is a powerful, production-ready NestJS library designed to accelerate the development of dynamic, data-driven applications. It provides a robust backend infrastructure for managing pages, layouts, and configurations at runtime, with built-in support for multi-tenancy, soft deletion, backups, and enterprise-grade security.

🚀 Key Features

• 🏢 Multi-Tenancy Architecture: Native support for tenant-specific page configurations and overrides.
• 📄 Dynamic Page Management: Create, update, and serve page layouts (JSON-based) dynamically via API.
• 🔄 Version Control & Backup: Automatic tracking of changes with updated_date_time and full restore capabilities.
• ♻️ Restore & Copy Operations: Easily restore deleted pages or duplicate existing pages (even across tenants).
• 🔐 License Validation: Built-in secure license key validation (Trial & Enterprise tiers).
• ⚡ High Performance: Optimized queries with PostgreSQL and TypeORM.
• 🛡️ Secure: Input validation, soft-delete mechanisms, and robust error handling.

📦 Installation

Install the package via NPM:

npm install @vonome-codepack/vonome-builder-nestjs

Peer Dependencies

Ensure you have the following peer dependencies installed in your NestJS project:

npm install @nestjs/common @nestjs/core @nestjs/cqrs @nestjs/typeorm @nestjs/mapped-types typeorm pg class-validator class-transformer reflect-metadata rxjs

🔑 Commercial Licensing & Support

This is a commercial product. To use @vonome-codepack/vonome-builder-nestjs in a production environment, you must obtain a valid license key from Vonome Software and Systems.

License Tiers

1. Trial License: 30-day full access for evaluation.
2. Enterprise License: Unlimited tenants, pages, and production usage.

How to Get a License

Please contact our sales team to purchase a license or request a trial key:

• 📧 Email: info@vonome.com
• 🌐 Website: https://vonome.com
• 💼 LinkedIn: Vonome Team

License Agreement

By installing or using this software, you agree to the terms specified in the LICENSE file. Unauthorized redistribution or use without a valid license is strictly prohibited.

🛠 Quick Start Guide

1. Import the Module

Import VonomeBuilderModule in your app.module.ts. You must provide your License Key and Database Configuration.

import { Module } from '@nestjs/common';
import { ConfigModule, ConfigService } from '@nestjs/config';
import { VonomeBuilderModule } from '@vonome-codepack/vonome-builder-nestjs';

@Module({
  imports: [
    ConfigModule.forRoot({ isGlobal: true }),
    VonomeBuilderModule.forRootAsync({
      imports: [ConfigModule],
      useFactory: (config) => ({
        licenseKey: config.get('VONOME_LICENSE_KEY'), // Your purchased key
        database: {
          type: 'postgres',
          host: config.get('DB_HOST', 'localhost'),
          port: 5432,
          username: config.get('DB_USER', 'postgres'),
          password: config.get('DB_PASSWORD'),
          database: config.get('DB_NAME', 'pagebuilder'),
          synchronize: config.get('NODE_ENV') === 'development', // Auto-run migrations in dev
        },
      }),
      inject: [ConfigService],
    }),
  ],
})
export class AppModule {}

2. Basic Usage

Use PageBuilderService to create and manage pages programmatically.

import { Injectable } from '@nestjs/common';
import { PageBuilderService, PageType } from '@vonome-codepack/vonome-builder-nestjs';

@Injectable()
export class SetupService {
  constructor(private readonly pageBuilderService: PageBuilderService) {}

  async createDashboard() {
    return await this.pageBuilderService.createGlobalPage({
      systemModule: 'Sales',
      pageType: PageType.DASHBOARD,
      name: 'sales_overview',
      displayName: 'Sales Overview',
      routingUrl: '/sales/overview',
      // Dynamic Layout Definition
      appPageLayout: {
        sections: [
          { type: 'stats', widgets: ['revenue', 'users'] }
        ]
      }
    });
  }
}

🔧 Customization & Extension

You can extend the base controllers to add custom logic, changing routes, or override validation. ### Extending GlobalPageController typescript import { Controller, Post, Body, BadRequestException } from "@nestjs/common"; import { GlobalPageController, PageBuilderService, CreateGlobalPageDto } from "@vonome-codepack/vonome-builder-nestjs"; @Controller('page-builder') // Custom route prefix export class PageBuilderController extends GlobalPageController { constructor(pageBuilderService: PageBuilderService) { super(pageBuilderService); } // Example: Override create method with custom validation @Post() async create(@Body() createDto: CreateGlobalPageDto) { if (!createDto.name.startsWith('page-')) { throw new BadRequestException('Page name must start with "page-"'); } return super.create(createDto); } }

📚 API References

The library automatically exposes RESTful endpoints for your frontend to consume.

Global Pages (Admin/Default)

Tenant Pages (Custom Overrides)

All requests require header: x-tenant-id: <UUID>

For detailed code examples, see EXAMPLES.md. For database schema changes, see MIGRATION-GUIDE.md.

🤝 Support & Feedback

We are committed to the success of your project.

• Technical Support: Contact us at info@vonome.com for implementation assistance.
• Bug Reports: Please email us directly with a reproduction case.
• Feature Requests: We value your feedback! Let us know what would make Vonome Builder even better for you.

Copyright (c) 2026 Vonome Software and Systems. All Rights Reserved.