club-site-admin

This system drives the Low Fell Running Club website. It is built using the Keystone.js CMS/application platform for node.js.

Development

There are various grunt tasks available to aid development:

grunt --help

In addition the test suite can be run via npm test

This is done via webpack, set to run as an npm script:

npm run webpack
npm run webpack-prod

The production bundles are version controlled - and must be regenerated manually.

The site is based on the sass build of Bootstrap, with theming based upon Bootswatch.
To regenerate styles: grunt css
(Alternatively grunt watch will trigger regeneration on source changes)

emails sent from the system use the Mailgun service: https://www.mailgun.com/
email addresses to receive system-generated messages are configured in Site Config.
The .env file (root dir) must contain settings necessary to connect with mailgun, e.g.

MAILGUN_DOMAIN=sandboxd123abc123abc123abc123abc123abc1.mailgun.org
MAILGUN_DOMAIN=nameofmailgundomain.mailgun.org

uploaded images are hosted using the Cloudinary service: http://cloudinary.com/
The .env file (root dir) must contain settings necessary to connect with cloudinary, e.g.

CLOUDINARY_URL=cloudinary://123412341234123:-ABCABCABCABCABCABCABCABCAB@account

uploaded files are hosted using Amazon S3 storage: https://aws.amazon.com/s3/
A bucket, and access key pair must be pre-configured for the site to use
The .env file (root dir) must contain bucket/access key settings required to connect with S3, e.g.

S3_KEY=ABCABCABCABCABCABCAB
S3_SECRET=123412341234123123412341234123abc/+12341
S3_BUCKET=nameofpreconfiguredbucket
S3_REGION=eu-west-1

This software is available under the MIT license.