mirror of
https://github.com/bigchaindb/site.git
synced 2024-11-25 11:08:29 +01:00
Matthias Kretschmann
6ede38abfc
- start linting scss based on Airbnb style guide - add includePaths to css & js tasks
122 lines
3.3 KiB
Markdown
122 lines
3.3 KiB
Markdown
# BigchainDB
|
|
|
|
> Landing page for BigchainDB
|
|
|
|
[](https://travis-ci.com/ascribe/bigchain-website)
|
|
|
|
[Live](https://www.bigchaindb.com) | [Styleguide](https://www.bigchaindb.com/styleguide/) | [Beta](http://beta.bigchaindb.com) | [Gamma](http://gamma.bigchaindb.com)
|
|
|
|
## Development
|
|
|
|
You need to have the following tools installed on your development machine before moving on:
|
|
|
|
- [node.js](http://nodejs.org/) & [npm](https://npmjs.org/)
|
|
- (optional) use [Yarn](https://yarnpkg.com) instead of npm for faster dependency installations
|
|
- [Ruby](https://www.ruby-lang.org) (for sanity, install with [rvm](https://rvm.io/))
|
|
- [Bundler](http://bundler.io/)
|
|
|
|
### Install dependencies
|
|
|
|
Run the following command from the repository's root folder to install all dependencies.
|
|
|
|
```bash
|
|
npm i && bundle install
|
|
```
|
|
|
|
or
|
|
|
|
```bash
|
|
yarn && bundle install
|
|
```
|
|
|
|
### Development build
|
|
|
|
Spin up local dev server and livereloading watch task, reachable under [https://localhost:1337](https://localhost:1337):
|
|
|
|
```bash
|
|
gulp
|
|
```
|
|
|
|
## Continuous Delivery
|
|
|
|
The site gets built & deployed automatically via Travis under the following conditions:
|
|
|
|
- every push builds the site
|
|
- every push to the master branch initiates a live deployment
|
|
- every pull request initiates a beta deployment
|
|
|
|
## Manual Deployment
|
|
|
|
The site is hosted in an S3 bucket and gets deployed via a gulp task.
|
|
|
|
### Prerequisite: Authentication
|
|
|
|
To deploy the site, you must authenticate yourself against the AWS API with your AWS credentials. Get your AWS access key and secret and add them to `~/.aws/credentials`:
|
|
|
|
```
|
|
[default]
|
|
aws_access_key_id = <YOUR_ACCESS_KEY_ID>
|
|
aws_secret_access_key = <YOUR_SECRET_ACCESS_KEY>
|
|
```
|
|
|
|
This is all that is needed to authenticate with AWS if you've setup your credentials as the default profile.
|
|
|
|
If you've set them up as another profile, say `[bigchain]` you can grab those credentials by using the `AWS_PROFILE` variable like so:
|
|
|
|
```bash
|
|
AWS_PROFILE=bigchain gulp deploy --live
|
|
```
|
|
|
|
In case that you get authentication errors or need an alternative way to authenticate with AWS, check out the [AWS documentation](http://docs.aws.amazon.com/AWSJavaScriptSDK/guide/node-configuring.html).
|
|
|
|
### Staging build & beta deployment
|
|
|
|
The staging build is essentially a full production build but it prevents search engine indexing & Google Analytics tracking.
|
|
|
|
```bash
|
|
# make sure your local npm packages & gems are up to date
|
|
npm update && bundle update
|
|
|
|
# make staging build in /_dist
|
|
gulp build --staging
|
|
|
|
# deploy contents of /_dist to beta
|
|
gulp deploy --beta
|
|
```
|
|
|
|
There's also a second beta deployment target called gamma under http://gamma.bigchaindb.com:
|
|
|
|
```bash
|
|
# build preventing search engine indexing & Google Analytics tracking
|
|
gulp build --staging
|
|
|
|
# deploy contents of /_dist to gamma
|
|
gulp deploy --gamma
|
|
```
|
|
|
|
|
|
### Production build & live deployment
|
|
|
|
```bash
|
|
# make sure your local npm packages & gems are up to date
|
|
npm update && bundle update
|
|
|
|
# make production build in /_dist
|
|
gulp build --production
|
|
|
|
# deploy contents of /_dist to live
|
|
gulp deploy --live
|
|
```
|
|
|
|
## Coding conventions
|
|
|
|
### (S)CSS
|
|
|
|
Follows [Airbnb CSS / Sass Styleguide](https://github.com/airbnb/css). Lint with [scss-lint](https://github.com/brigade/scss-lint).
|
|
|
|
Rule exceptions:
|
|
|
|
- indentation: 4 spaces
|
|
- use single quotes
|
|
- allow single line rule sets
|