Elemo

The next-generation project management platform.
Explore the docs · Check Storybook

Join our Discord or Slack · Bug report · Feature request

About

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.

Try Elemo

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. Install Mise, then bootstrap the toolchain and demo data

   # Mise installs Go, Node, pnpm, and the rest of the pinned tools from mise.toml.
   # Also required on the host: Docker (with the Compose plugin) and openssl.
   # Bootstrap does not start services or modify databases.
   mise trust
   mise bootstrap
   ./scripts/dev-demo-init.sh --yes

3. Start the frontend

   # Compose is already running after init-demo; this starts the web app too
   mise run dev

4. Now, you can try Elemo. Navigate to http://127.0.0.1:3000 and log in using the [email protected] email and AppleTree123 password.

Contributing

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.

Codespaces/Dev Containers

Configuration for codespaces/dev containers are available. For more information check out the related documentation.

Plugin authors should start with the plugin developer guide.

License

Elemo is source-available under FSL-1.1-ALv2:

• You may read, modify, and self-host Elemo for internal use.
• You may not offer Elemo (or substantially similar functionality) to others as a competing commercial product or hosted service for two years after each version is published. After that, that version becomes Apache 2.0.
• Elemo Cloud is Licensor’s hosted service and is governed by its own terms, not by FSL.

A commercial license is available if you need Competing Use rights (OEM, white-label, or third-party hosting). Contact [email protected].

Git tags published before this FSL switch remain available under AGPL-3.0 as originally licensed.