From 1b0be20fb6eeff6c0e1dd456586e742254226428 Mon Sep 17 00:00:00 2001 From: benjag Date: Fri, 1 Mar 2024 20:43:16 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20=20@=20d9309?= =?UTF-8?q?98d5ff1899db3cf693fb8dad943f847cd1b=20=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 45 ++++++--------------------------------------- 1 file changed, 6 insertions(+), 39 deletions(-) diff --git a/README.md b/README.md index bf7225aa1..504ce592a 100644 --- a/README.md +++ b/README.md @@ -9,13 +9,9 @@ and a set of themes that build on this scaffolding. We started this project in 2 The project has evolved into what it is today, and will continue to grow to fit our expanding needs. Feel free to watch the Cedar grow and learn from what we are doing, or jump in and provide some recommendations. -### Vue 3 Migration Status - -Cedar has been fully migrated to Vue 3 using the composition API and is using [vite](https://vitejs.dev/) for its build system. Additionally, [vitest](https://vitest.dev/) is now being used as our testing framework. - ## Using Cedar -See the [Cedar docs](https://rei.github.io/rei-cedar-docs/) for usage instructions. +See the [Cedar docs](https://cedar.rei.com) for usage instructions. ## Getting Started @@ -31,12 +27,6 @@ Clone the project. Runs locally for development. Has hot reloading, and other nice things related to development. -Sometimes the liveReload server will hang in the background, do the following... - -Works on MacOS: - -`kill -9 $(lsof -ti tcp:35729)` - ## Testing ### Code Tests @@ -45,40 +35,17 @@ Works on MacOS: Runs unit tests. +`npm run watch` + +Runs unit tests in watch mode. This also allows you to inspect snapshot discrepancies and regenerate the snapshots if appropriate. + `npm run e2e` Runs [Nightwatch](http://nightwatchjs.org/) end-to-end tests and Axe a11y tests. `npm run test` -Runs both unit and e2e/accesibility tests. - -### Visual Regression Testing - -> [!NOTE] -> this has been temporarily disabled due to Vue3 compatibility issues. - -Check [backstop](https://github.com/garris/BackstopJS) for general configuration questions. - -Our visual regressions audits can be performed against all patterns documented within the project's component proving grounds. To do so, follow the steps below: - -1. Run the project locally with `npm run dev` -2. `npm run reference` will create a base set of images providing coverage for all defined patterns. Ensure this is run against a clean build prior to any edits. -3. `npm run compare` after making changes to the markup or css. This will create another set of test images and compare them against those generated in the previous step. -4. Review the generated report that should open in your browser. Make sure all changes are what you expect. -5. `npm run approve` if everything looks good. This will promote the latest test images to be the new reference images that future tests will be compared against. - -If you want to do backstop tests against a single scenario you can do `npm run compare -- --filter=