amber-ui

Prerequisites

You will need the following things properly installed on your computer.

• Git
• Node.js
• Yarn
• Ember CLI
• Google Chrome

Installation

• git clone <repository-url> this repository
• cd amber-ui
• yarn install

Running / Development

• ember serve
• Visit your app at http://localhost:4200.
• Visit your tests at http://localhost:4200/tests.

Code Generators

Make use of the many generators for code, try ember help generate for more details

Running Tests

• ember test
• ember test --server to run tests after every file change

Test data

For the generation of test data, we use ember-cli-mirage. Data is created in factories and randomized using Faker.

Preview generated data

To preview generated data in the browser, set ENV['ember-cli-mirage'].enabled to true for development in config/environment.js. The content generated for development is described in mirage/scenarios/default.js.

Linting

• yarn lint
• yarn lint:fix

Building

• ember build (development)
• ember build --environment production (production)

Deploying

Deployments are done using GitHub Actions. To deploy a branch, follow the following steps:

• Go to the Continuous Delivery workflow page.
• Open the "Run workflow" modal.
• Choose a branch and if you want to merge the changes on the staging branch into the master branch (only possible when the branch chosen in previous step is master).
• Click the green button "Run workflow".

Note: If the workflow fails with an error message about blobs along the lines of the following: buildx failed with: ERROR: failed to solve: [...] blob [...]: remove all recent cache files for staging on the Caches page and try again. You might have to turn on the option Perform all jobs, regardless of whether there are actual changes? to force the workflow to re-execute all its jobs.

Further Reading / Useful Links

• ember.js
• ember-cli
• Development Browser Extensions
  • ember inspector for chrome
  • ember inspector for firefox