MongoDB Compass

The MongoDB GUI.

Development

Running Compass locally requires Node.js and npm:

Node.js: ^12.4.0
npm: >=6.13.0

npm install
npm start [compass|compass-readonly|compass-isolated]

Plugins

Current Plugin API Version: 3.0.0

Majority of Compass' functionality lives in various plugins outside the main repo. This repo just brings them all together. All external plugins are tagged via the compass-plugin topic in the mongodb-js organisation. There are also various compass-tools and compass-ui-tools packages that help put together the application.

Plugins can be added to Compass by requiring them as a dependency in package.json, and by adding their installed location to the distribution plugin list also in the package.json. Plugin's apiVersion field has to match Compass'. Currently it's at 3.0.0.

Example of adding a dependency:

npm i -S @mongodb-js/compass-aggregations@latest

And in package.json:

"distributions": {
"plugin-prefix": "@mongodb-js/compass",
"default": "compass",
"compass": {
"name": "mongodb-compass",
"plugins": [
"node_modules/@mongodb-js/compass-aggregations", // add compass-aggregations// rest of the plugins required for this distribution
],
"styles": [
"index"
]
},
// other distribution config
}

Plugin Roles

Compass determines functionality of a plugin based on its registered Role. There are a few mains ones that we use:

Instance.Tab - Display as tabs in the instance context of the app. For example, server-status-plugin.
Database.Tab - Display as tabs in the database context of the app. compass-collections-ddl is registered as a Database.Tab, for example.
Collection.Tab - Display as sub tabs in the collection context of the app. A good example of this is the compass-crud.
Global.Modal - Will open as modal dialogs in any context of the app. These can be separate plugins entirely, or part of an existing plguin that does something else. For example, compass-aggregations is an Collection.Tab, but also registers a Global.Modal.
Collection.ScopedModal - Will open as a modal scoped in the collection context. compass-import-export, for example, registers 2 ScopedModals - one for import and the other for export.

Creating a New Plugin

We use a template to create new plugins. It comes set up with packages we might need to be using, and an electron environment to debug and test the plugin. The template is managed by khaos

npm i -g khaos
khaos create mongodb-js/compass-plugin ./my-plugin

Contributing

For issues, please create a ticket in our JIRA Project.

For contributing, please refer to CONTRIBUTING.md

Is there anything else you’d like to see in Compass? Let us know by submitting suggestions in out feedback forum.

License

SSPL

MongoDB Compass

The MongoDB GUI.

Development

Running Compass locally requires Node.js and npm:

Node.js: ^12.4.0
npm: >=6.13.0

npm install
npm start [compass|compass-readonly|compass-isolated]

Plugins

Current Plugin API Version: 3.0.0

Majority of Compass' functionality lives in various plugins outside the main repo. This repo just brings them all together. All external plugins are tagged via the compass-plugin topic in the mongodb-js organisation. There are also various compass-tools and compass-ui-tools packages that help put together the application.

Plugins can be added to Compass by requiring them as a dependency in package.json, and by adding their installed location to the distribution plugin list also in the package.json. Plugin's apiVersion field has to match Compass'. Currently it's at 3.0.0.

Example of adding a dependency:

npm i -S @mongodb-js/compass-aggregations@latest

And in package.json:

"distributions": {
"plugin-prefix": "@mongodb-js/compass",
"default": "compass",
"compass": {
"name": "mongodb-compass",
"plugins": [
"node_modules/@mongodb-js/compass-aggregations", // add compass-aggregations// rest of the plugins required for this distribution
],
"styles": [
"index"
]
},
// other distribution config
}

Plugin Roles

Compass determines functionality of a plugin based on its registered Role. There are a few mains ones that we use:

Instance.Tab - Display as tabs in the instance context of the app. For example, server-status-plugin.
Database.Tab - Display as tabs in the database context of the app. compass-collections-ddl is registered as a Database.Tab, for example.
Collection.Tab - Display as sub tabs in the collection context of the app. A good example of this is the compass-crud.
Global.Modal - Will open as modal dialogs in any context of the app. These can be separate plugins entirely, or part of an existing plguin that does something else. For example, compass-aggregations is an Collection.Tab, but also registers a Global.Modal.
Collection.ScopedModal - Will open as a modal scoped in the collection context. compass-import-export, for example, registers 2 ScopedModals - one for import and the other for export.

Creating a New Plugin

We use a template to create new plugins. It comes set up with packages we might need to be using, and an electron environment to debug and test the plugin. The template is managed by khaos

npm i -g khaos
khaos create mongodb-js/compass-plugin ./my-plugin

Contributing

For issues, please create a ticket in our JIRA Project.

For contributing, please refer to CONTRIBUTING.md

Is there anything else you’d like to see in Compass? Let us know by submitting suggestions in out feedback forum.

License

SSPL

MongoDB Compass

The MongoDB GUI.

Development

Running Compass locally requires Node.js and npm:

Node.js: ^12.4.0
npm: >=6.13.0

npm install
npm start [compass|compass-readonly|compass-isolated]

Plugins

Current Plugin API Version: 3.0.0

Majority of Compass' functionality lives in various plugins outside the main repo. This repo just brings them all together. All external plugins are tagged via the compass-plugin topic in the mongodb-js organisation. There are also various compass-tools and compass-ui-tools packages that help put together the application.

Plugins can be added to Compass by requiring them as a dependency in package.json, and by adding their installed location to the distribution plugin list also in the package.json. Plugin's apiVersion field has to match Compass'. Currently it's at 3.0.0.

Example of adding a dependency:

npm i -S @mongodb-js/compass-aggregations@latest

And in package.json:

"distributions": {
"plugin-prefix": "@mongodb-js/compass",
"default": "compass",
"compass": {
"name": "mongodb-compass",
"plugins": [
"node_modules/@mongodb-js/compass-aggregations", // add compass-aggregations// rest of the plugins required for this distribution
],
"styles": [
"index"
]
},
// other distribution config
}

Plugin Roles

Compass determines functionality of a plugin based on its registered Role. There are a few mains ones that we use:

Instance.Tab - Display as tabs in the instance context of the app. For example, server-status-plugin.
Database.Tab - Display as tabs in the database context of the app. compass-collections-ddl is registered as a Database.Tab, for example.
Collection.Tab - Display as sub tabs in the collection context of the app. A good example of this is the compass-crud.
Global.Modal - Will open as modal dialogs in any context of the app. These can be separate plugins entirely, or part of an existing plguin that does something else. For example, compass-aggregations is an Collection.Tab, but also registers a Global.Modal.
Collection.ScopedModal - Will open as a modal scoped in the collection context. compass-import-export, for example, registers 2 ScopedModals - one for import and the other for export.

Creating a New Plugin

We use a template to create new plugins. It comes set up with packages we might need to be using, and an electron environment to debug and test the plugin. The template is managed by khaos

npm i -g khaos
khaos create mongodb-js/compass-plugin ./my-plugin

Contributing

For issues, please create a ticket in our JIRA Project.

For contributing, please refer to CONTRIBUTING.md

Is there anything else you’d like to see in Compass? Let us know by submitting suggestions in out feedback forum.

License

SSPL

MongoDB Compass

The MongoDB GUI.

Development

Running Compass locally requires Node.js and npm:

Node.js: ^12.4.0
npm: >=6.13.0

npm install
npm start [compass|compass-readonly|compass-isolated]

Plugins

Current Plugin API Version: 3.0.0

Majority of Compass' functionality lives in various plugins outside the main repo. This repo just brings them all together. All external plugins are tagged via the compass-plugin topic in the mongodb-js organisation. There are also various compass-tools and compass-ui-tools packages that help put together the application.

Plugins can be added to Compass by requiring them as a dependency in package.json, and by adding their installed location to the distribution plugin list also in the package.json. Plugin's apiVersion field has to match Compass'. Currently it's at 3.0.0.

Example of adding a dependency:

npm i -S @mongodb-js/compass-aggregations@latest

And in package.json:

"distributions": {
"plugin-prefix": "@mongodb-js/compass",
"default": "compass",
"compass": {
"name": "mongodb-compass",
"plugins": [
"node_modules/@mongodb-js/compass-aggregations", // add compass-aggregations// rest of the plugins required for this distribution
],
"styles": [
"index"
]
},
// other distribution config
}

Plugin Roles

Compass determines functionality of a plugin based on its registered Role. There are a few mains ones that we use:

Instance.Tab - Display as tabs in the instance context of the app. For example, server-status-plugin.
Database.Tab - Display as tabs in the database context of the app. compass-collections-ddl is registered as a Database.Tab, for example.
Collection.Tab - Display as sub tabs in the collection context of the app. A good example of this is the compass-crud.
Global.Modal - Will open as modal dialogs in any context of the app. These can be separate plugins entirely, or part of an existing plguin that does something else. For example, compass-aggregations is an Collection.Tab, but also registers a Global.Modal.
Collection.ScopedModal - Will open as a modal scoped in the collection context. compass-import-export, for example, registers 2 ScopedModals - one for import and the other for export.

Creating a New Plugin

We use a template to create new plugins. It comes set up with packages we might need to be using, and an electron environment to debug and test the plugin. The template is managed by khaos

npm i -g khaos
khaos create mongodb-js/compass-plugin ./my-plugin

Contributing

For issues, please create a ticket in our JIRA Project.

For contributing, please refer to CONTRIBUTING.md

Is there anything else you’d like to see in Compass? Let us know by submitting suggestions in out feedback forum.

License

SSPL

MongoDB Compass

The MongoDB GUI.

Development

Running Compass locally requires Node.js and npm:

Node.js: ^12.4.0
npm: >=6.13.0

npm install
npm start [compass|compass-readonly|compass-isolated]

Plugins

Current Plugin API Version: 3.0.0

Majority of Compass' functionality lives in various plugins outside the main repo. This repo just brings them all together. All external plugins are tagged via the compass-plugin topic in the mongodb-js organisation. There are also various compass-tools and compass-ui-tools packages that help put together the application.

Plugins can be added to Compass by requiring them as a dependency in package.json, and by adding their installed location to the distribution plugin list also in the package.json. Plugin's apiVersion field has to match Compass'. Currently it's at 3.0.0.

Example of adding a dependency:

npm i -S @mongodb-js/compass-aggregations@latest

And in package.json:

"distributions": {
"plugin-prefix": "@mongodb-js/compass",
"default": "compass",
"compass": {
"name": "mongodb-compass",
"plugins": [
"node_modules/@mongodb-js/compass-aggregations", // add compass-aggregations// rest of the plugins required for this distribution
],
"styles": [
"index"
]
},
// other distribution config
}

Plugin Roles

Compass determines functionality of a plugin based on its registered Role. There are a few mains ones that we use:

Instance.Tab - Display as tabs in the instance context of the app. For example, server-status-plugin.
Database.Tab - Display as tabs in the database context of the app. compass-collections-ddl is registered as a Database.Tab, for example.
Collection.Tab - Display as sub tabs in the collection context of the app. A good example of this is the compass-crud.
Global.Modal - Will open as modal dialogs in any context of the app. These can be separate plugins entirely, or part of an existing plguin that does something else. For example, compass-aggregations is an Collection.Tab, but also registers a Global.Modal.
Collection.ScopedModal - Will open as a modal scoped in the collection context. compass-import-export, for example, registers 2 ScopedModals - one for import and the other for export.

Creating a New Plugin

We use a template to create new plugins. It comes set up with packages we might need to be using, and an electron environment to debug and test the plugin. The template is managed by khaos

npm i -g khaos
khaos create mongodb-js/compass-plugin ./my-plugin

Contributing

For issues, please create a ticket in our JIRA Project.

For contributing, please refer to CONTRIBUTING.md

Is there anything else you’d like to see in Compass? Let us know by submitting suggestions in out feedback forum.

License

SSPL

MongoDB Compass

The MongoDB GUI.

Development

Running Compass locally requires Node.js and npm:

Node.js: ^12.4.0
npm: >=6.13.0

npm install
npm start [compass|compass-readonly|compass-isolated]

Plugins

Current Plugin API Version: 3.0.0

Majority of Compass' functionality lives in various plugins outside the main repo. This repo just brings them all together. All external plugins are tagged via the compass-plugin topic in the mongodb-js organisation. There are also various compass-tools and compass-ui-tools packages that help put together the application.

Plugins can be added to Compass by requiring them as a dependency in package.json, and by adding their installed location to the distribution plugin list also in the package.json. Plugin's apiVersion field has to match Compass'. Currently it's at 3.0.0.

Example of adding a dependency:

npm i -S @mongodb-js/compass-aggregations@latest

And in package.json:

"distributions": {
"plugin-prefix": "@mongodb-js/compass",
"default": "compass",
"compass": {
"name": "mongodb-compass",
"plugins": [
"node_modules/@mongodb-js/compass-aggregations", // add compass-aggregations// rest of the plugins required for this distribution
],
"styles": [
"index"
]
},
// other distribution config
}

Plugin Roles

Compass determines functionality of a plugin based on its registered Role. There are a few mains ones that we use:

Instance.Tab - Display as tabs in the instance context of the app. For example, server-status-plugin.
Database.Tab - Display as tabs in the database context of the app. compass-collections-ddl is registered as a Database.Tab, for example.
Collection.Tab - Display as sub tabs in the collection context of the app. A good example of this is the compass-crud.
Global.Modal - Will open as modal dialogs in any context of the app. These can be separate plugins entirely, or part of an existing plguin that does something else. For example, compass-aggregations is an Collection.Tab, but also registers a Global.Modal.
Collection.ScopedModal - Will open as a modal scoped in the collection context. compass-import-export, for example, registers 2 ScopedModals - one for import and the other for export.

Creating a New Plugin

We use a template to create new plugins. It comes set up with packages we might need to be using, and an electron environment to debug and test the plugin. The template is managed by khaos

npm i -g khaos
khaos create mongodb-js/compass-plugin ./my-plugin

Contributing

For issues, please create a ticket in our JIRA Project.

For contributing, please refer to CONTRIBUTING.md

Is there anything else you’d like to see in Compass? Let us know by submitting suggestions in out feedback forum.

License

SSPL

MongoDB Compass

The MongoDB GUI.

Development

Running Compass locally requires Node.js and npm:

Node.js: ^12.4.0
npm: >=6.13.0

npm install
npm start [compass|compass-readonly|compass-isolated]

Plugins

Current Plugin API Version: 3.0.0

Majority of Compass' functionality lives in various plugins outside the main repo. This repo just brings them all together. All external plugins are tagged via the compass-plugin topic in the mongodb-js organisation. There are also various compass-tools and compass-ui-tools packages that help put together the application.

Plugins can be added to Compass by requiring them as a dependency in package.json, and by adding their installed location to the distribution plugin list also in the package.json. Plugin's apiVersion field has to match Compass'. Currently it's at 3.0.0.

Example of adding a dependency:

npm i -S @mongodb-js/compass-aggregations@latest

And in package.json:

"distributions": {
"plugin-prefix": "@mongodb-js/compass",
"default": "compass",
"compass": {
"name": "mongodb-compass",
"plugins": [
"node_modules/@mongodb-js/compass-aggregations", // add compass-aggregations// rest of the plugins required for this distribution
],
"styles": [
"index"
]
},
// other distribution config
}

Plugin Roles

Compass determines functionality of a plugin based on its registered Role. There are a few mains ones that we use:

Instance.Tab - Display as tabs in the instance context of the app. For example, server-status-plugin.
Database.Tab - Display as tabs in the database context of the app. compass-collections-ddl is registered as a Database.Tab, for example.
Collection.Tab - Display as sub tabs in the collection context of the app. A good example of this is the compass-crud.
Global.Modal - Will open as modal dialogs in any context of the app. These can be separate plugins entirely, or part of an existing plguin that does something else. For example, compass-aggregations is an Collection.Tab, but also registers a Global.Modal.
Collection.ScopedModal - Will open as a modal scoped in the collection context. compass-import-export, for example, registers 2 ScopedModals - one for import and the other for export.

Creating a New Plugin

We use a template to create new plugins. It comes set up with packages we might need to be using, and an electron environment to debug and test the plugin. The template is managed by khaos

npm i -g khaos
khaos create mongodb-js/compass-plugin ./my-plugin

Contributing

For issues, please create a ticket in our JIRA Project.

For contributing, please refer to CONTRIBUTING.md

Is there anything else you’d like to see in Compass? Let us know by submitting suggestions in out feedback forum.

License

SSPL

MongoDB Compass

The MongoDB GUI.

Development

Running Compass locally requires Node.js and npm:

Node.js: ^12.4.0
npm: >=6.13.0

npm install
npm start [compass|compass-readonly|compass-isolated]

Plugins

Current Plugin API Version: 3.0.0

Majority of Compass' functionality lives in various plugins outside the main repo. This repo just brings them all together. All external plugins are tagged via the compass-plugin topic in the mongodb-js organisation. There are also various compass-tools and compass-ui-tools packages that help put together the application.

Plugins can be added to Compass by requiring them as a dependency in package.json, and by adding their installed location to the distribution plugin list also in the package.json. Plugin's apiVersion field has to match Compass'. Currently it's at 3.0.0.

Example of adding a dependency:

npm i -S @mongodb-js/compass-aggregations@latest

And in package.json:

"distributions": {
"plugin-prefix": "@mongodb-js/compass",
"default": "compass",
"compass": {
"name": "mongodb-compass",
"plugins": [
"node_modules/@mongodb-js/compass-aggregations", // add compass-aggregations// rest of the plugins required for this distribution
],
"styles": [
"index"
]
},
// other distribution config
}

Plugin Roles

Compass determines functionality of a plugin based on its registered Role. There are a few mains ones that we use:

Instance.Tab - Display as tabs in the instance context of the app. For example, server-status-plugin.
Database.Tab - Display as tabs in the database context of the app. compass-collections-ddl is registered as a Database.Tab, for example.
Collection.Tab - Display as sub tabs in the collection context of the app. A good example of this is the compass-crud.
Global.Modal - Will open as modal dialogs in any context of the app. These can be separate plugins entirely, or part of an existing plguin that does something else. For example, compass-aggregations is an Collection.Tab, but also registers a Global.Modal.
Collection.ScopedModal - Will open as a modal scoped in the collection context. compass-import-export, for example, registers 2 ScopedModals - one for import and the other for export.

Creating a New Plugin

We use a template to create new plugins. It comes set up with packages we might need to be using, and an electron environment to debug and test the plugin. The template is managed by khaos

npm i -g khaos
khaos create mongodb-js/compass-plugin ./my-plugin

Contributing

For issues, please create a ticket in our JIRA Project.

For contributing, please refer to CONTRIBUTING.md

Is there anything else you’d like to see in Compass? Let us know by submitting suggestions in out feedback forum.

License

SSPL

Name		Name	Last commit message	Last commit date
.evergreen		.evergreen
.github		.github
release		release
scripts		scripts
src		src
test		test
.babelrc		.babelrc
.eslintignore		.eslintignore
.eslintrc		.eslintrc
.evergreen.yml		.evergreen.yml
.gitignore		.gitignore
.npmrc		.npmrc
.snyk		.snyk
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
THIRD-PARTY-NOTICES.md		THIRD-PARTY-NOTICES.md
compass-screenshot.png		compass-screenshot.png
package-lock.json		package-lock.json
package.json		package.json

Name		Name	Last commit message	Last commit date
.evergreen		.evergreen
.github		.github
release		release
scripts		scripts
src		src
test		test
.babelrc		.babelrc
.eslintignore		.eslintignore
.eslintrc		.eslintrc
.evergreen.yml		.evergreen.yml
.gitignore		.gitignore
.npmrc		.npmrc
.snyk		.snyk
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
THIRD-PARTY-NOTICES.md		THIRD-PARTY-NOTICES.md
compass-screenshot.png		compass-screenshot.png
package-lock.json		package-lock.json
package.json		package.json

Name		Name	Last commit message	Last commit date
.evergreen		.evergreen
.github		.github
release		release
scripts		scripts
src		src
test		test
.babelrc		.babelrc
.eslintignore		.eslintignore
.eslintrc		.eslintrc
.evergreen.yml		.evergreen.yml
.gitignore		.gitignore
.npmrc		.npmrc
.snyk		.snyk
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
THIRD-PARTY-NOTICES.md		THIRD-PARTY-NOTICES.md
compass-screenshot.png		compass-screenshot.png
package-lock.json		package-lock.json
package.json		package.json

Name		Name	Last commit message	Last commit date
.evergreen		.evergreen
.github		.github
release		release
scripts		scripts
src		src
test		test
.babelrc		.babelrc
.eslintignore		.eslintignore
.eslintrc		.eslintrc
.evergreen.yml		.evergreen.yml
.gitignore		.gitignore
.npmrc		.npmrc
.snyk		.snyk
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
THIRD-PARTY-NOTICES.md		THIRD-PARTY-NOTICES.md
compass-screenshot.png		compass-screenshot.png
package-lock.json		package-lock.json
package.json		package.json

Name		Name	Last commit message	Last commit date
.evergreen		.evergreen
.github		.github
release		release
scripts		scripts
src		src
test		test
.babelrc		.babelrc
.eslintignore		.eslintignore
.eslintrc		.eslintrc
.evergreen.yml		.evergreen.yml
.gitignore		.gitignore
.npmrc		.npmrc
.snyk		.snyk
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
THIRD-PARTY-NOTICES.md		THIRD-PARTY-NOTICES.md
compass-screenshot.png		compass-screenshot.png
package-lock.json		package-lock.json
package.json		package.json

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

MongoDB Compass

Development

Plugins

Plugin Roles

Creating a New Plugin

Contributing

License

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

MongoDB Compass

Development

Plugins

Plugin Roles

Creating a New Plugin

Contributing

License

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

MongoDB Compass

Development

Plugins

Plugin Roles

Creating a New Plugin

Contributing

License

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

MongoDB Compass

Development

Plugins

Plugin Roles

Creating a New Plugin

Contributing

License

About

Resources