Skip to content

Commit

Permalink
📝 #26 updating contributing & deployment
Browse files Browse the repository at this point in the history
  • Loading branch information
nadnoslen committed Oct 26, 2019
1 parent 7de4e13 commit 451a9c9
Show file tree
Hide file tree
Showing 2 changed files with 51 additions and 41 deletions.
79 changes: 38 additions & 41 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,45 +1,33 @@
# How To Contribute

## Setup
## Clone & Setup

* `git clone git@github.com:cybertooth-io/ember-simple-auth-aws-amplify.git`
* `cd ember-simple-auth-aws-amplify`
* `yarn`
* `yarn install`

### Building The Add-on
## Linting

* `ember b`
* `ember build`
* `yarn lint:hbs`
* `yarn lint:js`
* `yarn lint:js --fix`

### Linting

* `npm run lint:hbs`
* `npm run lint:js`
* `npm run lint:js -- --fix`

### Running tests
## Running tests

* `ember test` – Runs the test suite on the current Ember version
* `ember test --server` – Runs the test suite in "watch mode"
* `ember try:each` – Runs the test suite against multiple Ember versions

### Running The Dummy Application

* `ember server`
* Visit your app at http://localhost:4200.
## Running the dummy application

For more information on using ember-cli, visit [http://ember-cli.com/](http://ember-cli.com/).
* `ember serve`
* Visit the dummy application at [http://localhost:4200](http://localhost:4200).

## Upgrading The Add-On
For more information on using ember-cli, visit [https://ember-cli.com/](https://ember-cli.com/).

When upgrading this add-on, after successfully performing `ember init` use the following
commands to install the following dependencies required by this add-on.
## Deployment Guide

```bash
ember install ember-auto-import
ember install ember-concurrency
yarn add @aws-amplify/auth @aws-amplify/core ember-simple-auth
```
Visit the [Deployment](DEPLOYMENT.md) guide.

## Linking This Add-on For Local Testing

Expand All @@ -56,6 +44,8 @@ $ yarn link ember-simple-auth-aws-amplify

Note: I've actually had to go into my _other project_ and put this into its `package.json`:
`"ember-simple-auth-aws-amplify": "link:../ember-simple-auth-aws-amplify",`
or
`"ember-simple-auth-aws-amplify": "*",`

### Unlinking

Expand All @@ -68,23 +58,30 @@ $ yarn unlink
$ yarn unlink ember-simple-auth-aws-amplify
```

## Deploying The Dummy Application

Make sure your `~/.aws/credentials` file has a profile named _cybertooth_
with a valid key and secret,

```
[cybertooth]
aws_access_key_id = <KEY>
aws_secret_access_key = <SECRET>
```

Deploy by invoking the following command: `ember deploy production`

Confirm your changes are showing up in our S3 container: http://ember-simple-auth-aws-amplify.cybertooth.io/
## Commiting Code

Fork and submit a pull request.

Try to use an emoji to help describe the commit:

* 🎉 Initial Commit
* 🔖 Version Tag
* ✨ New Feature
* 🐛 Bugfix
* 🔒 Security Fix
* 📇 Metadata
* ♻️ Refactoring
* 📚 Documentation
* 🌐 Internationalization
* ♿️ Accessibility
* 🐎 Performance
* 🎨 Cosmetic
* 🔧 Tooling
* 🚨 Tests
* 💩 Deprecation
* 🗑 Removal
* 🚧 Work In Progress

You may need to go into AWS CloudFront to expire the index.html file before the site
changes are picked up (see [issue](https://github.com/cybertoothca/ember-cli-text-support-mixins/issues/29)).

## Releasing & Publishing To NPM

Expand Down
13 changes: 13 additions & 0 deletions DEPLOYMENT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
Deployment
==============================================================================

Typically run:

```bash
$ ember deploy production
```

If you need to force the current branch to be the LATEST:
```bash
$ ADDON_DOCS_UPDATE_LATEST=true ember deploy production
```

0 comments on commit 451a9c9

Please sign in to comment.