eventcatalog.config.js
Overview
eventcatalog.config.js
contains configurations for your site and is placed in the root directory of your site.
Required fields
title
- Type:
string
Title for your website.
module.exports = {
title: 'EventCatalog',
};
organizationName
- Type:
string
Your organization name.
module.exports = {
organizationName: 'Your Company',
};
Optional fields
editUrl
- Type:
string
URL used when people want to edit the documentation. For example your GitHub repo and branch.
module.exports = {
editUrl: 'https://github.com/boyney123/eventcatalog-demo/edit/master',
};
tagline
Tagline that is shown on your homepage.
module.exports = {
tagline: 'Discover, Explore and Document your Event Driven Architectures',
};
logo
Alt and path to your company logo.
Example, if your logo is in public/logo.png
:
EventCatalog will look inside the public directory, no need to put this into your string value
module.exports = {
logo: {
src: '/logo.png',
alt: 'My Company Logo',
},
};
homepageLink
- Type:
string
URL used when people want to link the logo & title in the top navigation to the homepage of a website.
module.exports = {
homepageLink: 'https://eventcatalog.dev',
};
users
Add user information here. You can reference these inside your Event and Service markdown files.
module.exports = {
users: [
{
id: 'dboyne',
name: 'David Boyne',
avatarUrl: 'https://pbs.twimg.com/profile_images/1262283153563140096/DYRDqKg6_400x400.png',
role: 'Developer',
summary: 'Currently building tools for Event Architectures.',
},
],
};
generators
- Type:
any[]
module.exports = {
generators: [],
};
headerLinks
Type:
Link[]
Type:
Link
label
: value that gets rendered on the UIhref
: URL for link
module.exports = {
headerLinks: [
{ label: 'Events', href: '/events' },
{ label: 'Services', href: '/services' },
{ label: 'Domains', href: '/domains' },
{ label: 'Visualiser', href: '/visualiser' },
{ label: '3D Node Graph', href: '/overview' },
],
};
Adding or Removing Pages from the Navigation Bar
Using the headerLinks
configuration you can add or remove any links you like in your header bar. If you want to remove a link to the page simplify just remove that item from the array.
footerLinks
Type:
FooterLink[]
Type:
FooterLink
label
: value that gets rendered on the UIhref
: URL for link
module.exports = {
footerLinks: [
{ label: 'Events', href: '/events' },
{ label: 'Services', href: '/services' },
{ label: '3D Node Graph', href: '/overview' },
{ label: 'GitHub', href: 'https://github.com/boyney123/eventcatalog-demo/edit/master' },
],
};
analytics
- Type:
googleAnalyticsTrackingId
: value for the Google Analytics tracking ID
module.exports = {
analytics: { googleAnalyticsTrackingId: 'GA-XXXXX-X' },
};
basePath
Set the basePath
in order to be able to deploy the eventcatalog under a sub-path of the domain.
module.exports = {
basePath: '/my-catalog',
};
trailingSlash
Changes the trailing slash behaviour of next.js.
module.exports = {
trailingSlash: true,
};
openGraph
Manage the Open Graph tags that are used for social media sharing.
- Type:
openGraphConfig
ogTitle
: Open Graph title, this is the title that is shown in previews on Facebook & Slack. Defaults totitle
as set in the config.ogDescription
: Open Graph description, this is used for the description meta tag. Defaults totagline
as set in the config.ogUrl
: Open Graph URL, the homepage of your website. Defaults tohomepageLink
as set in the config.ogImage
: Open Graph image location (can be relative or absolute)
module.exports = {
openGraph: {
ogTitle: 'EventCatalog | Discover, Explore and Document your Event Driven Architectures.',
ogDescription: 'An open source tool powered by markdown to document your Event Driven Architecture.',
ogUrl: 'https://eventcatalog.dev/',
ogImage: 'https://eventcatalog.dev/img/opengraph.png',
},
};