Skip to content

Developing

Jessica Mulein edited this page Jul 6, 2023 · 11 revisions

Developing on HACC

Setting up the local dev environment

You will be able to use HACC as a nuget package without checking out the toplevel development repository, but should you choose to make changes locally or contribute to HACC, you'll want to do a recursive clone of the HACC.Development repository.

If you're on Windows, I (@JessicaMulein) highly recommend Git for Windows which will give you a Git Bash available under Windows Terminal.

  • Rider likes to put things under ~/RiderProjects/ (I think)
  • Visual studio likes to put things under ~/source/repos
  • @JessicaMulein likes to put things under /s (for source) due to long path name issues
  1. Change into source directory
  • Git Bash:

    $ cd /c/s 
    
  • Linux:

    $ cd /s
    
  1. Clone the repository
$ git clone --recursive https://github.com/Blazor-Console/HACC
$ cd HACC
$ # broken for now; ./setupKeybase.sh # sets up keybase remotes
$ git submodule foreach git checkout main
  1. Install npm (for canvas)
  • Node.JS
  • If you are installing Node.js on windows for the first time then you must restart before HACC.Demo builds. The installer doesn't prompt for restart and the error is a bit cryptic for the solution "the command npm install exited with code 9009"
  • This can also be installed as an option/component of the Visual Studio 2022 installation

Branch Structure

image

Clone this wiki locally