Junction Assets

Junction Assets is the home to Insight's shared components and style declarations

Contributing to Junction Assets

1. Make necessary changes to projects/junction-assets/...

• For style based changes, modify src/assets/scss/...
• For component based changes (i.e. changes to header/footer), modify src/lib/...

2. Push your changes to the insight/junction-assets project

Testing Junction Assets

Junction Assets cannot be run as a standalone application. It must be tied to a pre-existing Insight application. When you are done with your changes, you can test them in a pre-existing application as follows:

1. Ensure all the changes you've made are complete
2. Build the /dist folder using npm run build
3. Copy the junction-assets folder inside the generated /dist folder from step 2
4. Replace the @insight/junction-assets with the junction-assets folder you copied from step 3 into a pre-existing Insight application
5. Run the Insight application using ng serve --base-href /URL/ if necessary

Common Errors

My changes are not displaying after I copy junction-assets into an Insight application

• Make sure you are replacing @insight/junction-assets with dist/junction-assets built from npm run build
• Make sure you are modifying project/junction-assets/... and not src/...

Running npm run build fails causes a lot of errors

• Ensure that you have all the required packages by running npm install before running npm run build
• If you require additional packages, install them using npm install --save

After copying junction-assets, I get errors where @insight/junction-assets/... cannot be found

• Make sure that you are replacing @insight/junction-assets with dist/junction-assets
  • Do not use the base junction-assets (i.e. the entire project)