@redocly/developer-portal

Redocly Portal

Install

$: npm install

Run locally

$: npm start

Run tests locally.

• modify package.json by adding to scripts -> test -> PERCY_TOKEN=<token>. Use token from Percy.io
• run server npm run start-test-server
• run tests npm run test

Run cypress tests on PR before merge

Add label run_tests_cypress to the PR. It starts running cypress tests.

Publish Staging/Local envs

• To publish stage verdaccio on EC2 (for dependency testing)

• Change version in package.json to something meaningful and unique, like 1.1.0-beta.94-verify-fix
• npm i
• [Optional] Run npm run build to verify that your Portal version is working
• npm run prepublishOnly
• npm publish --registry http://[registry address]

• To publish local verdaccio

• Install local verdaccio. It has an official docker image you can use, and in most cases, the default configuration is good enough: docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio
• Change version in package.json to something meaningful and unique, like 1.1.0-beta.94-verify-fix
• npm i
• [Optional] Run npm run build to verify that your Portal version is working
• npm run prepublishOnly
• npm publish --registry http://0.0.0.0:4873

• Usage of published Portal version (starter, marketing, ....)

• Update dependencies in package.json with your published @redocly/developer-portal version
• yarn install --registry http://[registry address] for staging or yarn install --registry http://0.0.0.0:4873 for local env