This is a Next.js project bootstrapped with create-next-app.

Clone the repo.

git clone https://github.com/smartive-education/app-bytelight

Authenticating GitHub Registry

1. Create a personal GitHub access token.
2. Create a new ~/.npmrc file if one doesn't exist.
3. Include the following line, replacing TOKEN with your personal access token.

@smartive-education:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=[TOKEN]

3. Create a local security environment file for variables.

Create a .env file and copy these keys and insert confidential values

# Qwacker backend
NEXT_PUBLIC_QWACKER_API_URL= [QWACKER_API_URL]

# Authentication
NEXTAUTH_URL=[NEXTAUTH_URL]
NEXTAUTH_SECRET=[NEXTAUTH_SECRET]

TEST_URL=http://localhost:3000

ZITADEL_ISSUER=[ZITADEL ISSUER URL]
ZITADEL_CLIENT_ID=[ZITADEL CLIENT ID]

Next-App Installation

npm ci

Getting Started

First, run the development server:

npm run dev

Open http://localhost:3000 with your browser to see the result.

To build the application local run:

npm run build

Scripts

ESLint

ESLint is configured to check:

npm run lint
npm run lint:fix

Prettier

Prettier configuration:

• "@smartive/prettier-config"

npm run prettier
npm run prettier:check

TFLing, Prettier and ESLint

npm run style-check

Testing

Running Tests locally

This repository provides a set of e2e tests located in the tests directory. To run the tests locally, you can use the following command:

    npm run test:e2e:local

This will run the e2e tests without any screenshot tests.

Running Tests in Docker

To run the tests in a Docker container, you can use the following command:

    npm run test:e2e:docker

This command will pull the latests Playwright Image to run all the tests including screenshot tests within a Docker container.

Update screenshots in Docker

To update the screenshots, you can use the following command:

    npm run test:e2e:update-snapshot

Writing Tests

For information on how to write tests using Playwright, refer to the official Playwright Playwright documentation.