Elemo is a project management platform which aims to help developers to ship faster, project managers to have better project overview, and community members to be involved in the lifecycle of projects.

Elemo is not trying to reinvent the wheel, though it is introducing new abstractions in project management to allow any size of company an easy use.

The features listed below are part of the roadmap, but not necessarily implemented yet. The fully implemented features are marked with a checkmark.

• Organizations: Collaborate on projects across multiple organizations, whether it is your client, vendor, your subsidiary, or else.
• Roles: Create roles for organizations, namespaces, or projects. Be flexible. You decide on what permissions the role has.
• Namespaces: Organize your projects into namespaces, create namespace-specific roles and forget about team-named projects as a workaround.
• Projects: Group issues and documents into projects and keep everything related at one place. No more unnecessary back-and-forth between tabs.
• Issues: Create issues, attach related files, link documents, and more. Everything you need for the implementation at one place.
• Documents: Create rich documents, link them to issues, projects, or even namespaces.
• Todo lists: Track your Todo list within Elemo and create new items in the blink of an eye. No more "where did I put that note?!".
• Boards: Gain insights into the project's progress. No matter what project management methodology your team uses.
• Releases: Keep your releases where they belong to. Link releases to documents, issues, and so on.
• Roadmaps: Make sure you see the big picture and don't get lost in details.

Setting up the development environment is an easy and straightforward process, however, you will need to run the code on Linux, MacOS, or Windows WSL2. Follow the steps below and get ready to contribute:

1. Clone the repository

   # Clone the repository and change directory
   git clone https://github.com/opcotech/elemo.git && cd elemo

2. Set up and configure the services using an automated setup script

   # Make sure you have all the development requirements installed, then run the setup script.
   # Requirements: yq, jq, go, openssl, docker (with compose plugin), make, nvm
   ./scripts/setup.sh

3. Start the services

   # Start the backend services
   make start # or "make dev" for development

4. Now, you can try Elemo. Navigate to http://127.0.0.1:3000 and log in using the demo@elemo.app email and AppleTree123 password.

We welcome contributions to the project, whether it is source code, documentation, bug reports, feature requests or feedback. To get started with contributing:

• Have a look through GitHub issues labelled "good first issue".
• Read the contributing guide.
• For details on building Elemo, see the related Dockerfile.
• Create a fork of Elemo and submit a pull request with your proposed changes.