Before running any of these commands below, make sure to have installed:
VSCode - https://code.visualstudio.com/Download
NodeJS - https://nodejs.org/en/ (current, not LTS).
- Fork this repository at https://github.com/Pseudo-Corp/SynergismOfficial/fork
- Clone the repository you forked with
git clone https://github.com/<USERNAME>/SynergismOfficial
(make sure to change<USERNAME>
with your own Github username) - Open the repository you just downloaded in VSCode
- Install the project dependencies, running
npm install
(ormake install
- If you intend to usemake
from here and on, make sure it is installed first) - Install the liveserver extension for VSCode at https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer (or by searching for
Live Server
inside the Extensions Marketplace in VSCode. You can open the Extensions Marketplace by pressingCtrl+Shift+X
) - Switch to a new branch with
git checkout -b "my-branch-name"
- Run
npm run watch:esbuild
(ormake watch
) - Open the liveserver (bottom right corner icon similar to an Antenna in VSCode)
- Make your desired changes and test them. When you are done making changes, press
Ctrl+C
to exit from the previous command. - If any new files were created, run
git add /path/to/file
(orgit add -A
to add all) - Before commiting any changes you made, check and lint your code to see if everything you've done is good to go by doing steps 12 through 14
- Typecheck all your TypeScript files by running
npm run check:tsc
(ormake check
) - Lint the code by running
npm run lint
(ormake lintcode
) - Lint the CSS by running
npm run csslint
(ormake lintcss
) - If everything is good to go, commit your changes with
git commit -am "title of my commit"
- Push your changes to your personal Github Repository with
git push -u origin my-branch-name
- Open a Pull Request (PR) on the Official Synergism Repository at https://github.com/Pseudo-Corp/SynergismOfficial/pulls (make sure you click on
compare across forks
to select your fork and branch)
To get a list of available commands in the Makefile, run make help
or just make