Firrrrrrst!

Author: tsmorgan

.gitignore

@@ -0,0 +1,8 @@
+.sass-cache
+.DS_Store
+.start.pid
+public
+govuk_modules
+node_modules/*
+*.sublime-*
+docs

CHANGELOG.md

@@ -0,0 +1,3 @@
+# 1.0.0
+
+Initial release of prototyping kit

CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contribution guidelines
+
+We really like contributions and bug reports, in fact the project wouldn't have got to this stage without them. 
+We do have a few guidelines to bear in mind.
+
+## GOV.UK Elements
+
+The project contains code taken from the [GOV.UK Elements](https://github.com/alphagov/govuk_elements/) project.
+Please check that any issues related to that code are raised with that project, not this one.
+
+## Raising bugs
+
+When raising bugs please explain the issue in good detail and provide a guide to how to replicate it. 
+When describing the bug it's useful to follow the format:
+
+- what you did
+- what you expected to happen
+- what happened
+
+## Suggesting features
+
+Please raise feature requests as issues before contributing any code.
+This is just to ensure they are discussed properly before any time is spent on them.
+
+## Contributing code
+
+### Indentation and whitespace
+
+2-space, soft-tabs only please. No trailing whitespace.
+
+### Versioning
+
+We use [semantic versioning](http://semver.org/), and bump the version
+on master only. Please don't submit your own proposed version numbers.
+
+### Commit hygiene
+
+Please see our [git style guide](https://github.com/alphagov/styleguides/blob/master/git.md)
+which describes how we prefer git history and commit messages to read.

Gruntfile.js

@@ -0,0 +1,152 @@
+module.exports = function(grunt){
+  grunt.initConfig({
+    // Clean
+    clean: ['public', 'govuk_modules'],
+
+    // Builds Sass
+    sass: {
+      dev: {
+        options: {
+          style: "expanded",
+          sourcemap: true,
+          includePaths: [
+            'govuk_modules/govuk_template/assets/stylesheets',
+            'govuk_modules/govuk_frontend_toolkit/stylesheets'
+          ],
+          outputStyle: 'expanded'
+        },
+        files: [{
+          expand: true,
+          cwd: "app/assets/sass",
+          src: ["*.scss"],
+          dest: "public/stylesheets/",
+          ext: ".css"
+        }]
+      }
+    },
+
+    // Copies templates and assets from external modules and dirs
+    copy: {
+      assets: {
+        files: [{
+          expand: true,
+          cwd: 'app/assets/',
+          src: ['**/*', '!sass/**'],
+          dest: 'public/'
+        }]
+      },
+      govuk: {
+        files: [{
+          expand: true,
+          cwd: 'node_modules/govuk_frontend_toolkit',
+          src: '**',
+          dest: 'govuk_modules/govuk_frontend_toolkit/'
+        },
+        {
+          expand: true,
+          cwd: 'node_modules/govuk_template_mustache/',
+          src: '**',
+          dest: 'govuk_modules/govuk_template/'
+        }]
+      },
+    },
+
+    // workaround for libsass
+    replace: {
+      fixSass: {
+        src: ['govuk_modules/govuk_template/**/*.scss', 'govuk_modules/govuk_frontend_toolkit/**/*.scss'],
+        overwrite: true,
+        replacements: [{
+          from: /filter:chroma(.*);/g,
+          to: 'filter:unquote("chroma$1");'
+        }]
+      }
+    },
+
+    // Watches assets and sass for changes
+    watch: {
+      css: {
+        files: ['app/assets/sass/**/*.scss'],
+        tasks: ['sass'],
+        options: {
+          spawn: false,
+        }
+      },
+      assets:{
+        files: ['app/assets/**/*', '!app/assets/sass/**'],
+        tasks: ['copy:assets'],
+        options: {
+          spawn: false,
+        }
+      }
+    },
+
+    // nodemon watches for changes and restarts app
+    nodemon: {
+      dev: {
+        script: 'server.js',
+        options: {
+          ext: 'js',
+          ignore: ['node_modules/**', 'app/assets/**', 'public/**'],
+          args: grunt.option.flags()
+        }
+      }
+    },
+
+    concurrent: {
+        target: {
+            tasks: ['watch', 'nodemon'],
+            options: {
+                logConcurrentOutput: true
+            }
+        }
+    }
+  });
+
+  [
+    'grunt-contrib-copy',
+    'grunt-contrib-watch',
+    'grunt-contrib-clean',
+    'grunt-sass',
+    'grunt-nodemon',
+    'grunt-text-replace',
+    'grunt-concurrent'
+  ].forEach(function (task) {
+    grunt.loadNpmTasks(task);
+  });
+
+  grunt.registerTask(
+    'convert_template',
+    'Converts the govuk_template to use mustache inheritance',
+    function () {
+      var script = require(__dirname + '/lib/template-conversion.js');
+
+      script.convert();
+      grunt.log.writeln('govuk_template converted');
+    }
+  );
+
+  grunt.registerTask('generate-assets', [
+    'clean',
+    'copy',
+    'convert_template',
+    'replace',
+    'sass'
+  ]);
+
+  grunt.registerTask('default', [
+    'generate-assets',
+    'concurrent:target'
+  ]);
+
+  grunt.event.on('watch', function(action, filepath, target) {
+
+    // just copy the asset that was changed, not all of them
+
+    if (target == "assets"){
+      grunt.config('copy.assets.files.0.src', filepath.replace("app/assets/",""));
+    }
+
+  });
+
+};

LICENCE.txt

@@ -0,0 +1,19 @@
+Copyright (C) 2014 HM Government (Government Digital Service)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Procfile

@@ -0,0 +1 @@
+web: node ./node_modules/grunt-cli/bin/grunt --gruntfile Gruntfile.js generate-assets && node server.js

README.md

@@ -0,0 +1,87 @@
+# GOV.UK Prototyping Kit
+
+The kit provides a simple way to make interactive prototypes that look like pages on GOV.UK. These prototypes can be used to show ideas to people you work with, and to do user research.
+
+It's built on the [Express](http://expressjs.com/) framework, and uses these GOV.UK resources:
+
+- [GOV.UK template](https://github.com/alphagov/govuk_template)
+- [GOV.UK front end toolkit](https://github.com/alphagov/govuk_frontend_toolkit)
+- [GOV.UK elements](https://github.com/alphagov/govuk_elements)
+
+Read the [project principles](docs/principles.md).
+
+## Requirements
+
+#### [Node](http://nodejs.org/)
+
+You may already have it, try:
+
+```
+node --version
+```
+
+Your version should be 4.2.2.
+
+If you don't have Node, download it here: [http://nodejs.org/](http://nodejs.org/).
+
+## Getting started
+
+Install Node.js (see requirements)
+
+#### Download the prototype kit
+
+[Download the zip file](https://github.com/alphagov/govuk_prototype_kit/archive/master.zip)
+
+Unzip the file
+
+#### Install dependencies
+
+Open a command line app (Terminal on OSX) and change to the unzipped directory. Then run:
+
+```
+npm install
+```
+
+This will install extra code that the prototype kit needs.
+
+#### Run the app
+
+```
+node start.js
+```
+
+Go to [localhost:3000](http://localhost:3000) in your browser.
+
+If you want to view multiple prototypes at the same time you can give them unique port numbers, like this:
+
+```
+PORT=3005 node start.js
+```
+
+To avoid conflicts we recommend using ports between 3000 and 3009. To change the port number permanently, edit the port variable in /server.js.
+
+#### Hot reload
+
+Any code changes should update in the browser without you restarting the app.
+
+The app recompiles app/assets/stylesheets/application.scss everytime changes are observed.
+
+## Documentation
+
+- [Prototyping kit principles](docs/principles.md)
+- [Getting started](docs/getting-started.md)
+- [Making pages](docs/making-pages.md)
+- [Writing CSS](docs/writing-css.md)
+- [Deploying (getting your work online)](docs/deploying.md)
+- [Updating the kit to the latest version](docs/updating-the-kit.md)
+- [Tips and tricks](docs/tips-and-tricks.md)
+- [Creating routes (server-side programming)](docs/creating-routes.md)
+
+This project is built on top of Express, the idea is that it is straightforward to create simple static pages out of the box. However, you're not limited to that - more dynamic sites can be built with more understanding of Express. Here's a good [Express tutorial.](http://code.tutsplus.com/tutorials/introduction-to-express--net-33367)
+
+## Community
+
+We have two Slack channels for this app. You'll need a government email address to join them.
+
+* [Slack channel for users of the Prototype Kit](https://ukgovernmentdigital.slack.com/messages/prototype-kit/)
+* [Slack channel for developers of the Prototype Kit](https://ukgovernmentdigital.slack.com/messages/prototype-kit-dev/)

VERSION.txt

@@ -0,0 +1 @@
+1.0.0