This project lost traction and will be archived. If you find this and wish to pick it up, please join us and consider resubmitting a proposal.
This version of Trailsy is a Code for Boulder project that uses OuterSpatial API calls to retrieve OpenTrails data published by Boulder County Parks and Open Space.
It has been forked from the original Code for America 2013 Trailsy project found here.
In a nutshell it is a pure client side JavaScript browser app to show the trails in and around Boulder, Colorado based on data from our parks and open space.
Q: What is OpenTrails data?
A: OpenTrails data is a data specification that can be used to build apps to help people know about trails.
The goal is to allow public agencies around the United States to publish their data in the same way so apps can be developed for the public to use to explore trails. Much much more may be found at the OpenTrail Data Website
- Please try the application at http://52.25.183.113 and send us feedback via issues.
- Peruse the OpenTrails working draft specification at https://docs.google.com/document/d/1KF8KAio-SqGHhh9oFY_KjfwIi3PePOHg7KfTSPh27fc/edit
- Check out the Trello Board https://trello.com/b/qzDMDsVJ/trails
- Helping to prioritize features and issues by coordinating between Boulder County Parks and Open Space and Trailhead Labs, the producer of OuterSpatial
- Fork this repo's master branch
- Pick up a work item from the "To Do" column of the trello board and place it in the "Doing" column and make a comment that you're working on it.
- Do your best to use some TDD sweetness for the work item you implement, once you're convinced you're done commit and push to your repo and submit a pull request
- Examine the data produced by OuterSpatial to discover what relationships exist within.
- Contribute your thoughts to the OpenTrails specification
This project depends on Node.js (for dependency management, the build step, and a dev server), which we will assume you've installed either from a binary here or using your favorite package manager.
All remaining instructions assume you have:
- Cloned this repo
- Opend a Terminal or other command line utility
- Changed the current directory to this repo
- Executing
npm installat the command prompt will install dependencies and make trails ready to run
- Test files can be found in the
specdirectory - Testing is done with jasmine
- Execute tests by running the command
jasmineat the prompt, use npm to install it if you get acommand not founderror
- Executing
npm startat the command prompt will launch a development server - You may now access your local version of the Trailsy app at
http://localhost:8080
To debug your local version of Trailsy in your browser's console and step through the individual javascript files that are packaged together into 'bundle.js', do the following:
- Stop your local version of the Trailsy app (e.g. use
Ctrl-Cat the command prompt) - Execute
npm run-script sourcemap - Start your local version of Trailsy just as in the above 'Running' section
Since the conversion to using OpenTrails is a WIP, expect some functionality to be missing.
- cd to the project directory and run the following commands
rm bundle.js bundle.js.mapwebpackmkdir distcp index.html distcp error.html distcp bundle.js distcp bundle.js.map distcp -r styles distcp -r img distmkdir dist/node_modulescp -r node_modules/bootstrap-drawer dist/node_modules
With RHEL / CentOS / Fedora
Switch to the root user
(e.g. On an AWS instance after you log in execute sudo su -)
Install git via yum Clone this repository
Add the '--host [IP Address]' option into the 'start' line within the package.json file so trailsy is accessible outside of localhost.
- Webpack Server, documentation for webpack server
Install NodeJS and npm via the instructions here: https://github.com/joyent/node/wiki/installing-node.js-via-package-manager
Once NodeJS and npm are installed follow instructions from Building and then Running.
In the spirit of free software, everyone is encouraged to help improve this project.
This fork complies with the same copyright notice as derived from the original project. This project does not use Code for America and its contributors to promote or endorse other products.
This project is licensed under a BSD 3-clause license, which can be found here
This project would not be possible without the support of the Boulder County Parks and Open Space department and Trailhead Labs. Thank you!
The team includes
- Mario Barrenechea, developer
- Robert Soden, developer
- Sean Garborg, developer
- James Gould, developer
- Trevor Ackerman, developer
- You, if you're interested in volunteering!
You can contact us here if you would like to get involved.