Methodic Super Project

Get started developing faster!

This superproject helps you get started building on the Methodic platform by providing a single repository that pulls together all necessary projects so that you can develop and refactor with confidence.

Getting started

• Ensure your ssh-keys are generated. Add them to Github.

• Clone the superproject and all of its submodules:

    git clone ssh://[email protected]/methodic-labs/methodic.git --recurse-submodules
  

• Install gradle (brew install gradle)

• Install and start Postgresql (brew install postgres and brew services start postgres)

IntelliJ environment setup

We've found that using the built-in Import project at the root level works better than trying to use the gradle project generator. You should also enable annotation processing in the IntelliJ settings.

Running locally

• Ensure that:
  • You've completed the "Getting started" section above
  • Xcode is installed and you've agreed to the license
  • JAVA_HOME is configured properly and JDK 11 is installed

From the methodic superproject directory:

Tools provided

• ./gradlew - The superproject's build.gradle sets the 'developmentMode' variable, allowing you to build your projects using projectDependencies

Adding a new project

We manage subprojects using git submodules. See WORKFLOWS.md for some representative workflows.

If a new subproject needs to be added:

• edit settings.gradle to add it as a gradle subproject
• create a new branch using git checkout -b feature/add-<subproject>
• run git submodule add ssh://[email protected]/methodic-labs/<subproject>
• commit, push, and submit a pull request. git commit -a -m "Added subproject" && git push --set-upstream origin feature/add-<subproject>