mcoker/design-tracker-template

Red Hat UXD Design Tracker Template

This template is for creating a website to track designs created by a UXD team. Built on Jekyll using GitHub pages, this template will enable you to quickly get up and running with a basic set of sortable and filterable tables, patterns for adding designs links and sharing stories from any issue tracking system.

View the Changelog

View the Wiki

---

Installation

| This installation requires that you have Ruby, Node, Gem, Jekyll and Gulp installed. You can find a list of dependecies with versions here: Design Tracker Dependencies

1. Fork this repository
2. Rename as desired (we recommend with UX in the name)
3. Clone to your local machine
4. With Node, Gulp, Ruby, Gem and Jekyll already installed, run npm run initialize
5. Start with jekyll serve
6. Code away!

First Time Build

1. Verify that you have the following installed (see our Dependencies:
   • Node
   • Gulp
   • Gem
   • Jekyll
2. Run npm run initialize
   • commands as part of the script:
     • gem install bundler
     • bundle install
     • npm install
     • gulp
       • this will copy the files from your npm_modules directory to their respective locations for the jekyll build process
     • jekyll build
   • if this script fails, at the jekyll build step, run bundle exec jekyll build
3. run jekyll serve
   • for viewing locally at http://localhost:4000

Subsequent Builds

1. jekyll serve to start your environment on port :4000.

Troubleshooting

• If you are having issues with the site building, you can run a set of cleaning commands to reset your environment.
• If you have issues with the gem bundler, try to update your bundles with bundle update.

Environment Troubles

• npm run reinstall
  • This will clear out your node_modules folder, any vendor folders, reinstall all modules and copy vendor files back to their respective locations.
• gulp cleanVendors
  • This will remove just the vendor files that were copied over during the gulp process.
  • Run gulp to copy a clean set of vendor files back to your directories.