-
Notifications
You must be signed in to change notification settings - Fork 7
Home
Before developing make sure you know how to use the app by reading the user guide first. It will make coding much easier. This guide will try to teach you about how the tool’s code works. It is a shi- boatload* of information, so don’t worry if you can’t understand it in one go, the best way to understand how it works is to actually work on the code. A couple of pointers:
- At the time of writing this handover document, it isn’t clear what every function does as there aren’t comments for everything.
- As you work on the tool, always make sure that what you’ve written will make sense to other developers. This means writing docstrings/comments, and naming things properly.
This app is built using electron, which essentially allows you to turn a website into a desktop application. This means that the app is built using HTML, CSS, and JS. You should have an intermediate understanding of these languages before starting.
Refer here: https://www.electronjs.org/docs/latest/tutorial/tutorial-prerequisites You will need to enable windows developer mode before starting. This requires admin privileges so call IT to get this done (don’t put in a ticket, they’ll take weeks). There are several tools you will need to install before you can get started. You’ll need to get the local/portable versions of them as we don’t have admin privileges ☹.
- Code editor
VScode is recommended as its extensions will make development a lot faster.
- Git + Github
You’ll need Git and a Github account. Github desktop is highly recommended as it will make it easier to clone repositories and switch branches.
- node.js + npm
Fork this repository, and clone your fork using a git client such as GitHub desktop (recommended) or the command line.
Open a terminal window in the folder of your repository and run npm install. If using VScode, you can use the built in terminal to do this. This command will install all dependencies.
To build the app, run npm start. After you make an edit, use ctrl+r to refresh the page. If you make an edit to files outside of the "renderer" folder, you may need to run rs and fully restart the app to see your changes.