How to Dev With Us
**This page is a work in progress as we curate the best materials for new collabortors. **
Prerequisites
- Make a Github Profile
- Downdload a Code Editor (Visual Studio Code used for below instructions)
- Install Node & NPM
Setup Steps
- In top toolbar of VSCode, click Terminal > New Terminal
- Type
node -v
in Terminal. (Will likely generate error if you’ve never done this before). - Type
npm -v
in Terminal. (Will likely generate error if you’ve never done this before). - Download and Install Node & NPM and try Steps 1-3 again.
Installing Node & NPM
- https://www.guru99.com/download-install-node-js.html
- https://nodejs.org/en/download/
Continued Steps for Local Deployment
- Create a New Folder on your Computer where you’d like to store this code.
- In VSCode, go to File > Open Folder to begin working inside this Folder. You may be prompted to agree you “Trust the Authors.”
- Now in your Terminal, type
git clone https://github.com/XHARBOR/ThePortFront-TMP.git
- You may be prompted to Download and Install the Command Line Developer Tools. Please follow those instructions.
- If you needed Step 8, please repeat Step 7.
- You should see
Cloning into 'ThePortFront-TMP'...
as it clones the Repository - Now we can “Do the Thing!”
Go to the README page for the Git Repository at: https://github.com/XHARBOR/ThePortFront-TMP.git for more detailed instructions.
Note: Please do not
deploy
orcommit
changes to this README Repository to avoid confusing future users.
- Change Directory by typing
cd ThePortFront-TMP
- Now type in Terminal
npm install
- You will now need your own API Credentials to contribute your work to our database.
API Credentials
Our Technical Director Michael Morran is the Admin on Firebase (where your cues can be stored). You will need your own unique credentials to access and deploy changes to this site. Please contact Michael at theaterfestonline@gmail.com
to request your own credentials.
- In your folder structure in VSCode, look under ThePortFront-TMP > src > base.js
- Look for
appId: "aBUNchOFl3ttersAndNumbers",
- Add your API Key between the quotation marks
- Now you are ready to create and deploy cues locally on your computer.
- In Terminal, type
npm run dev
- This should launch your default web browser to the webpage
http://localhost:3000/
Mozilla Hubs Default
For additional resources, please see the standard Dev Overview for Mozilla Hubs.