Install Cypress and add a basic example test

apps/public/README.md

@@ -0,0 +1,8 @@
+# Public App v0
+
+This is the beginning of the public-facing DAHLIA app.
+
+## Running end-to-end tests locally
+* Start the Next.js server: `yarn dev`
+* In a separate terminal, open the Cypress app: `yarn run cypress open`
+* In the Cypress app, click on the test called "our_first_test.spec.js". This will open the Cypress test runner in a Chrome browser and run the test.

apps/public/cypress.json

@@ -0,0 +1 @@
+{}

apps/public/cypress/fixtures/example.json

@@ -0,0 +1,5 @@
+{
+  "name": "Using fixtures to represent data",
+  "email": "[email protected]",
+  "body": "Fixtures are a great way to mock data for responses to routes"
+}

apps/public/cypress/integration/our_first_test.spec.js

@@ -0,0 +1,14 @@
+describe('Our First Test', function() {
+  it("Loads the public app's homepage", function() {
+    cy.visit('http://localhost:3000')
+
+    // Check that the "Hello World" text is present on the page
+    cy.contains('Hello World')
+
+    // Find the About page link and click it
+    cy.contains('About').click()
+
+    // Should be on a new URL which includes '/about'
+    cy.url().should('include', '/about')
+  })
+})

apps/public/cypress/plugins/index.js

@@ -0,0 +1,17 @@
+// ***********************************************************
+// This example plugins/index.js can be used to load plugins
+//
+// You can change the location of this file or turn off loading
+// the plugins file with the 'pluginsFile' configuration option.
+//
+// You can read more here:
+// https://on.cypress.io/plugins-guide
+// ***********************************************************
+
+// This function is called when a project is opened or re-opened (e.g. due to
+// the project's config changing)
+
+module.exports = (on, config) => {
+  // `on` is used to hook into various events Cypress emits
+  // `config` is the resolved Cypress config
+}

apps/public/cypress/support/commands.js

@@ -0,0 +1,25 @@
+// ***********************************************
+// This example commands.js shows you how to
+// create various custom commands and overwrite
+// existing commands.
+//
+// For more comprehensive examples of custom
+// commands please read more here:
+// https://on.cypress.io/custom-commands
+// ***********************************************
+//
+//
+// -- This is a parent command --
+// Cypress.Commands.add("login", (email, password) => { ... })
+//
+//
+// -- This is a child command --
+// Cypress.Commands.add("drag", { prevSubject: 'element'}, (subject, options) => { ... })
+//
+//
+// -- This is a dual command --
+// Cypress.Commands.add("dismiss", { prevSubject: 'optional'}, (subject, options) => { ... })
+//
+//
+// -- This is will overwrite an existing command --
+// Cypress.Commands.overwrite("visit", (originalFn, url, options) => { ... })

apps/public/cypress/support/index.js

@@ -0,0 +1,20 @@
+// ***********************************************************
+// This example support/index.js is processed and
+// loaded automatically before your test files.
+//
+// This is a great place to put global configuration and
+// behavior that modifies Cypress.
+//
+// You can change the location of this file or turn off
+// automatically serving support files with the
+// 'supportFile' configuration option.
+//
+// You can read more here:
+// https://on.cypress.io/configuration
+// ***********************************************************
+
+// Import commands.js using ES2015 syntax:
+import './commands'
+
+// Alternatively you can use CommonJS syntax:
+// require('./commands')

apps/public/package.json

@@ -24,6 +24,7 @@
   "devDependencies": {
     "@types/node": "^12.6.8",
     "@types/react": "^16.8.23",
+    "cypress": "^3.4.0",
     "next-transpile-modules": "^2.3.1",
     "typescript": "^3.5.3",
     "webpack": "4.37.0"

apps/public/pages/about.tsx

@@ -0,0 +1,6 @@
+export default () => (
+  <>
+    <h1>About</h1>
+    <p>This is the about page.</p>
+  </>
+);