Plugin System - Ever Gauzy™ Platform

Plugin Structure

packages/plugins/
├── plugin-integration-github/     # GitHub integration
├── plugin-integration-upwork/     # Upwork integration
├── plugin-integration-hubstaff/   # HubStaff integration
├── plugin-integration-jira/       # Jira integration
├── plugin-integration-wakatime/   # Wakatime integration
├── plugin-job-search/             # Job search
├── plugin-job-matching/           # AI job matching
├── plugin-knowledge-base/         # KB module
├── plugin-changelog/              # Changelog tracking
└── plugin-product-reviews/        # Product reviews

Creating a Plugin

1. Create Module

import { Module } from "@nestjs/common";

@Module({
  imports: [],
  providers: [CustomPluginService],
  controllers: [CustomPluginController],
  exports: [CustomPluginService],
})
export class CustomPluginModule {}

2. Register Plugin

// In PluginModule or AppModule
@Module({
  imports: [
    // ... core modules
    CustomPluginModule,
  ],
})
export class AppModule {}

3. Add Entities

@MultiORMEntity("custom_plugin_data")
export class CustomPluginData extends TenantOrganizationBaseEntity {
  @MultiORMColumn()
  name: string;

  @MultiORMColumn({ nullable: true })
  value: string;
}

4. Register Entity

Add your entity to the plugin's module:

TypeOrmModule.forFeature([CustomPluginData]);
MikroOrmModule.forFeature([CustomPluginData]);

Plugin Guidelines

✅ Extend TenantOrganizationBaseEntity for tenant scoping
✅ Use Multi-ORM decorators
✅ Define API contracts in @gauzy/contracts
✅ Follow existing service/controller patterns
❌ Don't modify core entities directly
❌ Don't bypass tenant filtering

Plugin Structure

Creating a Plugin

1. Create Module

2. Register Plugin

3. Add Entities

4. Register Entity

Plugin Guidelines

Related Pages