carbon-components-svelte/docs/README.md
2020-07-19 12:04:50 -07:00

73 lines
No EOL
1.3 KiB
Markdown

# docs
This application was scaffolded using the default webpack [Sapper](https://github.com/sveltejs/sapper) template.
**Purpose**
- Write integration/end-to-end tests using Cypress
- Serve as an alternative component development environment to Storybook
- Build components in a Server-side Rendering (SSR) environment
## Getting Started
`carbon-components-svelte` must be linked in order to reflect live updates during component development.
In the root folder of this project, run the following:
```sh
# carbon-components-svelte/
yarn link
```
Then, in this folder, link the package and install the dependencies:
```sh
cd docs
# carbon-components-svelte/docs/
yarn link "carbon-components-svelte"
yarn install
```
## Available Scripts
### `yarn dev`
Runs the Sapper app in development mode.
### `yarn build`
Builds the app for production (static export only).
### `yarn test`
Runs Cypress integration tests in a headless browser (i.e. CLI only).
### `yarn:test:tdd`
Runs Cypress tests in the Cypress GUI. This is helpful when authoring new tests.
## Deploying to IBM Cloud
Deploy to IBM Cloud using the Staticfile buildpack.
### Log in
Log in using the IBM Cloud CLI:
```sh
ibmcloud login
# or if using Single-Sign On (SSO):
ibmcloud login --sso
```
### Deploy
Build and deploy the app:
```sh
yarn build
ibmcloud target --cf
ibmcloud cf push
```