A tool to create and manage needs
Ruby HTML CSS JavaScript
Latest commit 9730a30 Feb 23, 2017 @sihugh sihugh committed on GitHub Merge pull request #166 from alphagov/use-whitelist-for-fields-receiv…

Use a whitelist for the fields returned by the Publishing API
Failed to load latest commit information.
doc Create Rails 3.2.14 app Sep 27, 2013
lib Remove rake tasks for migrating data from the Need API Feb 14, 2017
test Remove unneeded require statements Feb 14, 2017
vendor Create Rails 3.2.14 app Sep 27, 2013
Gemfile Add the govspeak gem Jan 31, 2017
Gemfile.lock Run bundle update Feb 9, 2017
README.md Include the Gemfile in the list of dependencies Feb 15, 2017
Rakefile Autocorrect violations everywhere else Oct 16, 2015
startup.sh Add startup.sh Oct 8, 2014



Maslow is a tool to create and manage needs. It's a Rails app which is part of the GOV.UK Publishing Platform.


  • Ruby
  • Bundler
  • The Ruby Gems listed in the Gemfile
  • A running instance of the Publishing API

Getting started

The bootstrap script should get you up and running in the development environment. It runs Bundler and creates a stub user in the database.

bundle exec unicorn -p 3001

GDS development

If you're using the development VM, you should run the app from the development repository using Bowler and Foreman. The Need API will automatically be started alongside Maslow.

cd development/
bowl maslow

From your host machine, you should be able to access the app at http://maslow.dev.gov.uk/.

User accounts

Authentication is provided by the GDS-SSO gem, and in the production environment an instance of Signon must be running in order to sign in.

In the development environment, the mock strategy is used by default. This removes the requirement for authentication, instead returning the first user in the database as the current user. For this to work, a user must exist - there's a user defined in db/seeds.rb which will be created with the bootstrap script.