This is a skeleton starter theme for a Sorry status page. It comes with a bare bones file structure and a set of Grunt tasks to help you develop a theme from scratch.
For more details on theme development, read the docs on theming your status page.
- Download the latest version
- or clone the git repo:
git clone git@github.com:sorry-app/theme-skeleton.git
The simplest option if you don't wish to make any changes to the theme is to upload the zip file found in the dist folder through your user interface of your Sorry account.
If you make any changes you'll need to rezip your theme before you upload it, as per the Sorry docs.
To make development and deployment of the theme even easier you can use the included Grunt deployment tasks.
These tasks take the themes source code, bundle it into a deployable zip and upload it to your status page through the Sorry API.
From the command line:
- Navigate to the root of this downloaded theme project
- Run
npm install
.
npm will look at package.json and automatically install the necessary local dependencies listed there.
Unfamiliar with npm
? Don't have node installed? That's a-okay. npm stands for node packaged modules and is a way to manage development dependencies through node.js. Download and install node.js before proceeding.
We need somewhere to keep your Sorry login credentials. In the root of your project create a file called sorry.json
which contains your username and password - don't worry, this will NOT be commited to your repo as we've included it in .gitignore
.
{
"username": "your email address goes here",
"password": "your password goes here"
}
Now we have your authentication details in place we should be ready to deploy the theme. However, as per our docs we suggest you create a demo page for testing your theme, rather than deploying to your live page.
When you're ready to deploy, use the deploy
task from the command line:
grunt deploy --sorry-page="YOUR PAGE ID HERE"
You can find your page ID in the address bar of your Sorry account. A page URL of http://app.sorryapp.com/pages/my-page
suggests the page ID is my-page
.
This is a convenience method for watching all the core HTML, CSS and JS assets in your theme, whenever you make a change to these files grunt will automaticly bundle and deploy your theme as above.
Bumps the version number and creates a new git tag for the theme. You can append the release command with patch, minor or major depending on the version number increment you wish to make.
You don't need to use the release task, it can just be handy to organise released versions of the theme.
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.
Once you are happy that your contribution is ready for production please send us a pull request, at which point we'll review the code and merge it in.
For transparency and insight into our release cycle, and for striving to maintain backward compatibility, This project will be maintained under the Semantic Versioning guidelines as much as possible.
Releases will be numbered with the following format:
<major>.<minor>.<patch>
And constructed with the following guidelines:
- Breaking backward compatibility bumps the major (and resets the minor and patch)
- New additions without breaking backward compatibility bumps the minor (and resets the patch)
- Bug fixes and misc changes bumps the patch
For more information on SemVer, please visit http://semver.org/.
Robert Rawlins
Robin Geall
© Copyright 2014 - See LICENSE for details.