We really appreciate your interest and value your time. ApostropheCMS is free, open-source software, so community contributions are crucial to making it great. The guidelines below are meant to make the most of your time and work.
This is a condensed version of our contribution guide. You can find the full
guide at in the
@apostrophecms organization on Github (opens new window).
In addition to contributing to the project, you can also join the growing community on Discord (opens new window) for discussion, core development updates, and help as you build with Apostrophe. There are also the forum (opens new window) and Stack Overflow (opens new window).
- Code of Conduct
- How can I contribute?
- Should I make a new npm module?
# Code of Conduct
All contributors and community members are expected to abide by the Code of Conduct (opens new window). In short, be excellent to one another, respect everyone's contribution, and never harrass anyone for any reason. Alert the core team at email@example.com if you find someone failing to abide by the Code of Conduct.
# How can I contribute?
# Reporting Bugs
If you come across a bug, please submit an issue in the GitHub repo. Be sure to search the existing issues first and make sure it hasn’t already been logged. If it has, add a comment with any information you think might help resolve it.
If it hasn’t, check:
- Are you on the lastest minor version of the Apostrophe modules you're using?
- Is your dev environment up to date? Primarily this means a LTS version of Node.js and MongoDB 2.x or 3.x.
- Is this related to project code? Can you reproduce it in a minimal test case, without the rest of your project code? If it might be specific to your project, asking a question is a better first step (see below).
If the answer to those is "yes," please submit a bug issue. There is a bug issue template when you create one in Github to help with that.
# Suggesting a Feature or Enhancement
We track feature requests and larger scale enhancements within the GitHub repository. After you search existing issues to confirm your idea is new, please submit your idea as a new issue. Remember to include details that articulate the current functionality and how this enhancement will improve or build upon that. Again, there's an issue template to help you.
# Fixing Bugs or Submitting Enhancements
# Improving documentation
The documentation repo (opens new window) is public and we appreciate contributions. The core maintainers know Apostrophe very well, but that can make it hard to see where the gaps in documentation are.
Please open issues there letting us know (nicely, please). Even better, submit a pull request documenting something and you'll be helping many developers going forward. Even typo fixes are great!
# Share the Love
Authoring blog posts, giving talks at a meet-up, or otherwise sharing experiences using ApostropheCMS help spread the word. When you launch a site on ApostropheCMS, contact us in Discord (opens new window) or on Twitter (opens new window). We love a good success story.
# Should I make a new npm module?
Great question. If it's not a bug fix or an improvement to the core UI, it often
doesn't belong in the core
apostrophe npm module. For instance, our blogging
functionality is in the separate
apostrophe-blog npm module.
- You can take any Apostrophe project module (
lib/modules/my-module), move that to the root of its own repository and package it up as an npm module. It should just work, as long as all of your dependencies are part of the module. Set
peerDependenciesif this will rely on a module that isn't directly used in your code.
- Please do not use the
apostrophe-prefix for your module, or the
apos-prefix for your styles without consulting the core team. By reserving these for the official Apostrophe modules (which you are welcome to collaborate on), we can maintain clarity for new Apostrophe developers regarding which modules the core team is committed to maintaining.
- To avoid confusion, you can pick your own prefix. It's good practice to use a prefix so that you don't conflict with project-level modules.
apostrophe-cmsto your keywords in
package.jsonto help people find your module.
See publishing your own npm modules for Apostrophe for more information.