Skip to content

Latest commit

 

History

History
29 lines (24 loc) · 1.86 KB

README.md

File metadata and controls

29 lines (24 loc) · 1.86 KB

cdk-nextjs-standalone Examples

Each example app utilizes open-next's example Next.js apps. open-next's example apps are built to test core Next.js functionality so they're helpful for testing cdk-nextjs-standalone. We also don't want to reinvent the wheel. In order to use open-next's code within this repository we use git submodules. Read this guide for more info.

Prerequisites

  1. git clone https://github.com/jetbridge/cdk-nextjs.git
  2. yarn install
  3. yarn build

Setup Example Next.js Apps

After cloning this repository in order to run the example apps or e2e tests, run:

  1. Initialize git submodule: git submodule init && git submodule update
  2. Install dependencies: cd open-next && pnpm i
  3. Build packages pnpm build

Deploy Manually

To deploy an app manually to test them out for yourself, run:

  1. cd app-router # or any other example
  2. pnpm install
  3. Inject AWS Credentials into your terminal
  4. cdk deploy

Locally Run E2E Tests with Playwright

  1. Change directory into package with tests: cd open-next/packages/tests-e2e.
  2. Set URL environment variable for the project you want to test: APP_ROUTER_URL for appRouter project, PAGES_ROUTER_URL for pagesRouter project, and/or APP_PAGE_ROUTER_URL for appPagesRouter project. These urls will be the CloudFront domains from deployed examples/ CDK apps. You can find these in AWS Console or they'll be printed in your terminal after running cdk deploy.
  3. Run e2e tests with ui: pnpm playwright test --ui.
  4. Hit play (green play button) and watch tests run!

E2E Testing in CI

See .projenrc.ts run-e2e-tests workflow towards bottom. This functionality is commented out until an AWS account can be used to deploy the example apps and run the tests.