Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/projectcaluma/ember-caluma

Ember.js addons for Caluma
https://github.com/projectcaluma/ember-caluma

caluma ember-addon ember-engine emberjs form

Last synced: 3 days ago
JSON representation

Ember.js addons for Caluma

Awesome Lists containing this project

README

        

# ![ember-caluma](https://user-images.githubusercontent.com/6150577/137114875-8b9edb83-92ba-4b3a-ba6e-2e5f86afdcc5.png)

[![Test](https://github.com/projectcaluma/ember-caluma/workflows/Test/badge.svg)](https://github.com/projectcaluma/ember-caluma/actions?query=workflow%3ATest)
[![BrowserStack Status](https://automate.browserstack.com/badge.svg?badge_key=RFNMT2hyTnRjNVZkUitkWUl2d3BWK21KbnU3MU1tTGpHS2tOVHVCU1RrZz0tLXJjZ1J5VEZ6ZmtJWVpFdHpDRnREcFE9PQ==--3034affde596526379b7a0a19798a7ba1f79154c)](https://automate.browserstack.com/public-build/RFNMT2hyTnRjNVZkUitkWUl2d3BWK21KbnU3MU1tTGpHS2tOVHVCU1RrZz0tLXJjZ1J5VEZ6ZmtJWVpFdHpDRnREcFE9PQ==--3034affde596526379b7a0a19798a7ba1f79154c)
[![Codecov](https://codecov.io/gh/projectcaluma/ember-caluma/branch/main/graph/badge.svg)](https://codecov.io/gh/projectcaluma/ember-caluma)
[![Code Style: Prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)
[![License: LGPL-3.0](https://img.shields.io/badge/License-LGPL--3.0-blue.svg)](https://spdx.org/licenses/LGPL-3.0-or-later.html)

The Ember.js addons for [Caluma](https://caluma.io) - a collaborative form editing service.

## Browser support

| ![Edge](https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png) | ![Firefox](https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png) | ![Chrome](https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png) | ![Safari](https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari-ios/safari-ios_48x48.png) |
| :-------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------: |
| last 2 versions | last 2 versions | last 2 versions | last 2 versions |

## Compatibility

`@projectcaluma/ember-*` packages are guaranteed to work with the following LTS versions of Ember.js:

- 5.4
- 4.12

## Documentation

You can find the interactive documentation [here](https://docs.caluma.io/ember-caluma).

## Contributing

### Installation

- `git clone [email protected]:projectcaluma/ember-caluma`
- `cd ember-caluma`
- `pnpm install`

### Linting

- `pnpm lint`

### Running tests

- `pnpm --filter @projectcaluma/ember-[package] exec ember test` – Runs the test suite on the current Ember version
- `pnpm --filter @projectcaluma/ember-[package] exec ember test --server` – Runs the test suite in "watch mode"
- `pnpm --filter @projectcaluma/ember-[package] exec ember try:each` – Runs the test suite against multiple Ember versions

Cross-browser testing provided by:

BrowserStack

### Running the dummy application

#### With a mocked [Mirage.js](https://github.com/miragejs/ember-cli-mirage) backend

- `pnpm start`
- Visit the dummy application at [http://localhost:4200](http://localhost:4200).

#### With a dockerized [Caluma](https://github.com/projectcaluma/caluma) backend

- `docker compose up -d`
- `pnpm start-proxy`
- Visit the dummy application at [http://localhost:4200](http://localhost:4200).

### Updating the schema

The addon includes a mirage server for mocking Caluma's GraphQL API, which is generated from the GraphQL schema definition. If the upstream GraphQL schema changed you can update the addon by running

```bash
docker compose up -d
pnpm update-schema
pnpm update-possible-types
```

### Releasing

To release a new version, head over to [Actions](https://github.com/projectcaluma/ember-caluma/actions?query=workflow%3ARelease) and trigger a workflow run.
This will automatically check if a new version can be released, generate a changelog, draft a release and publish it on NPM.

## License

This project is licensed under the [LGPL-3.0-or-later license](LICENSE).

For further information on our license choice, you can read up on the [corresponding GitHub issue](https://github.com/projectcaluma/ember-caluma/issues/613).