Customization - Xentralia Docs

Xentralia is designed to be flexible. This guide covers how to customize the platform to fit your team’s workflow.

Dashboard Themes

Personalize your Xentralia dashboard experience:

export default {
  name: 'my-project',
  
  dashboard: {
    theme: 'dark', // 'light', 'dark', or 'system'
    accentColor: '#6366f1',
  },
};

Custom Domains

Connect your own domain to your deployments:

Via CLI

xentralia domains add myapp.com --environment production

Via Configuration

environments: {
  production: {
    domains: ['myapp.com', 'www.myapp.com'],
  },
},

Xentralia automatically provisions SSL certificates for custom domains.

Build Plugins

Extend the build process with plugins:

export default {
  name: 'my-project',
  
  plugins: [
    '@xentralia/plugin-analytics',
    '@xentralia/plugin-sentry',
    ['@xentralia/plugin-custom', { option: 'value' }],
  ],
};

Popular Plugins

Plugin	Description
@xentralia/plugin-analytics	Built-in analytics dashboard
@xentralia/plugin-sentry	Error tracking integration
@xentralia/plugin-lighthouse	Automated performance audits
@xentralia/plugin-preview	Enhanced preview deployments

Notifications

Configure where deployment notifications are sent:

export default {
  name: 'my-project',
  
  notifications: {
    slack: {
      webhook: process.env.SLACK_WEBHOOK,
      events: ['deployment.success', 'deployment.failure'],
    },
    email: {
      recipients: ['team@example.com'],
      events: ['deployment.failure'],
    },
  },
};

Team Permissions

Control who can do what in your project:

export default {
  name: 'my-project',
  
  team: {
    roles: {
      developer: {
        deploy: ['staging'],
        viewLogs: true,
      },
      admin: {
        deploy: ['staging', 'production'],
        manageTeam: true,
        viewLogs: true,
      },
    },
  },
};

Monorepo Support

For monorepo setups, specify the root directory:

export default {
  name: 'frontend-app',
  rootDirectory: 'apps/frontend',
};

Or use workspace detection:

xentralia init --workspace apps/frontend

CI/CD Integration

Integrate Xentralia into your existing CI/CD pipeline:

GitHub Actions

- name: Deploy to Xentralia
  uses: xentralia/deploy-action@v2
  with:
    token: ${{ secrets.VIREX_TOKEN }}
    environment: production

Generic CI

VIREX_TOKEN=$TOKEN xentralia deploy --environment production

Advanced: Custom Build Image

For specialized build requirements:

export default {
  name: 'my-project',
  
  build: {
    image: 'node:20-alpine',
    commands: [
      'apk add --no-cache python3',
      'npm ci',
      'npm run build',
    ],
  },
};

Next Steps

• Check the FAQ for common questions
• Join our Discord for community support