Workflow - Desktop

Add a file

Click Show in Explorer to see the root folder of your repository.
Then, save one or more supported PLC files into the root folder of your repository. After opening the Copia Desktop, you can view the rendered file.

Commit + Push a Change

In the lower left corner of Copia Desktop, fill in the box where you can add a summary of your change.
Select Commit to Master. This stores your change locally. You can make multiple changes and commit them before moving onto the next step.
Press the blue Push button. This "pushes" your local commits to the Copia server.
Congratulations! You can access your files directly from the browser at and anyone that clones this repo can easily download and get updates for this file.

Make a change

  1. 1.
    Make a change to a file. For example, delete a rung, modify a tag, or change a line of structured text.
  2. 2.
    Now save and overwrite your file in the root folder of your repository.
  3. 3.
    Open Copia Desktop
  4. 4.
    You should see the change rendered in the right-hand panel. This is called a diff.
Once you've confirmed that the changes are correct by looking at the diff, you'll be ready to commit and push the change.

Pull before you push

Once you begin to collaborate with other users, you'll both be making changes to the same repository. In order to stay synchronized, you need to follow one simple rule: pull before you push. Which means, make sure you've checked for remote changes before you try to push changes you've made locally.
You can think about it as you need to know what you're changing before you change it.
Press Fetch Origin to check the remote repository for changes. "Fetching" simply checks the repository, it doesn't pull in the remote changes.
Select Pull Origin to pull the changes from the remote repository. "Pulling" actually pulls the remote changes into your local repository (or file system)
There is a lot more to pulling, which you can learn more about in saving changes. Fortunately, Git always forces you to do the right thing and our Desktop App makes doing the right thing easy.

Individual Workflow

If you're working as an individual, this is all you really need to get going with Git and ensure your files are tracked. You can create your own repo and begin storing files.
If you're working with a team or other collaborators, you might want to check out the next section for the basics of collaboration with Git.

Collaboration With Git

While Git is a powerful tool for individual engineers to track and understand changes to their files, it truly shines when used in collaboration with multiple engineers.
Collaboration with Git gets powerful and complex with branching, merging, code review, etc. Copia itself supports collaboration features like orgs, teams, issue tracking, and wikis. We cover a lot of this in the "advanced section." However, if you're brand new to Git, we don't recommend trying too many of these features until you've gotten comfortable with simply pulling and pushing changes. For more on that, check out the next section.

View History

A repository includes a history of commits with the changes to the files in each commit. Click the History tab on the top left corner of the Copia Desktop app.
You should see the changes in each revision rendered in a panel to the right.