Hackathon guide

Create a github account.

Use the set up git instructions on github help.

• Ignore the part about the Native GitHub app.
• Using git bash, set up your username and email.
• Optionally setup authentication caching or SSH (we will not be covering this).

Get the source code

Create read-only clone of our appdevjs framework:

Change to the directory you would like to run your server from.

git clone https://github.com/appdevdesigns/appdevjs.git

All of our development is done in the develop branch. Run this command to set up that branch locally:

git checkout -b develop origin/develop

Set up prerequisites

Follow our readme to set up prerequisites

• Install nodejs
• Install some sort of mysql server
• Create a new database on that server

Install the framework

Follow the readme to install the appdevjs framework.

• "Installing" section
• "Web installer wizard" section

Visit this page: http://localhost:8088/page/site/componentManager

Install the appRAD module

Change directories to the modules folder.

Make a read-only clone of the appdevjs_appRAD repository:

git clone https://github.com/appdevdesigns/appdevjs_appRAD.git appRAD

Again, checkout the develop branch.

Launch the component manager and enable the module.

Visit the portal page.

Install the hris module

All of our active development for this hackathon will be in another repository, appdevdesigns/appdevjs_hris. Since we are developing in this repository, we will create forks instead of read-only copies.

Fork a repo instructions

• Change the part about the spoon-knife repository to the appdevjs_hris repository
• Use your github username to clone it (be sure you are in the modules directory)
• Configure remotes.