Configuration
Customization - JunleeBuild Docs
Customize JunleeBuild to fit your workflow. Learn about themes, plugins, and advanced configuration options.
JunleeBuild is designed to be flexible. This guide covers how to customize the platform to fit your team’s workflow.
Dashboard Themes
Personalize your JunleeBuild 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
junleebuild domains add myapp.com --environment production
Via Configuration
environments: {
production: {
domains: ['myapp.com', 'www.myapp.com'],
},
},
JunleeBuild automatically provisions SSL certificates for custom domains.
Build Plugins
Extend the build process with plugins:
export default {
name: 'my-project',
plugins: [
'@junleebuild/plugin-analytics',
'@junleebuild/plugin-sentry',
['@junleebuild/plugin-custom', { option: 'value' }],
],
};
Popular Plugins
| Plugin | Description |
|---|---|
@junleebuild/plugin-analytics | Built-in analytics dashboard |
@junleebuild/plugin-sentry | Error tracking integration |
@junleebuild/plugin-lighthouse | Automated performance audits |
@junleebuild/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:
junleebuild init --workspace apps/frontend
CI/CD Integration
Integrate JunleeBuild into your existing CI/CD pipeline:
GitHub Actions
- name: Deploy to JunleeBuild
uses: junleebuild/deploy-action@v2
with:
token: ${{ secrets.VIREX_TOKEN }}
environment: production
Generic CI
VIREX_TOKEN=$TOKEN junleebuild 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',
],
},
};