Setting up the project in your computer

:exclamation: Caution: Follow the steps in the following guide precisely. Things will not work out if you deviate in some steps.

You will need to fork the repo if you wish to contribute code to the CliniCal project. If you wish to only download the code without writing code, you can skip to the section for cloning the project.

If you wish to fork the repo:

  1. Navigate to the CliniCal repository on Github.
  2. Click on the button on the top-right hand corner of the page to fork the repository to your account.
  3. You should be automatically redirected to the fork on your personal account.

If you with to clone the repo:

  1. Install Git.
  2. On your page of your fork (or the CliniCal repository if you did not fork the repo), click on the and copy the link to the git repo by clicking on .
  3. Navigate to the folder on your computer that you wish to clone the repo to and run the command git clone (the link you copied earlier)

If you plan to use Intellij IDEA (highly recommended):

  1. Configure the JDK: Follow the guide [se-edu/guides] IDEA: Configuring the JDK to to ensure Intellij is configured to use JDK 11.
  2. Import the project as a Gradle project: Follow the guide [se-edu/guides] IDEA: Importing a Gradle project to import the project into IDEA.
    :exclamation: Note: Importing a Gradle project is slightly different from importing a normal Java project.
  3. Verify the setup:
    1. Run the seedu.address.Main and try a few commands.
    2. Run the tests to ensure they all pass.

Before writing code

  1. Configure the coding style

    If using IDEA, follow the guide [se-edu/guides] IDEA: Configuring the code style to set up IDEA’s coding style to match ours.

    :bulb: Tip: Optionally, you can follow the guide [se-edu/guides] Using Checkstyle to find how to use the CheckStyle within IDEA e.g., to report problems as you write code.

  2. Set up CI

    This project comes with a GitHub Actions config files (in .github/workflows folder). When GitHub detects those files, it will run the CI for your project automatically at each push to the master branch or to any PR. No set up required.

  3. Learn the design

    When you are ready to start coding, we recommend that you get some sense of the overall design by reading about AddressBook’s architecture.