Skip to content

A Next.js web project template πŸ‘· Built with a sense of peace and tranquillity πŸ™

License

Notifications You must be signed in to change notification settings

chrispoulter/halcyon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Halcyon

A Next.js web project template πŸ‘· Built with a sense of peace and tranquillity πŸ™

Features

Getting Started

Prerequisites

Install dependencies

Install NPM packages:

npm install

Configure environment variables

For local development, you'll need to create a .env.local file in the root of the project to define the environment variables. This file is ignored by Git, so the secrets will not be committed to the repository.

NEXT_PUBLIC_VERSION=1.0.0-local

NEXT_PUBLIC_API_URL=http://localhost:5257

JWT_SECURITY_KEY=super_secret_key_that_should_be_changed
JWT_ISSUER=HalcyonApi
JWT_AUDIENCE=HalcyonClient

AUTH_URL=http://localhost:3000
AUTH_SECRET=super_secret_key_that_should_be_changed

Running the development server

Once the dependencies are installed, you can run the development server:

npm run dev

Open http://localhost:3000 in your browser to see the project running.

Building for Production

To build the project for production:

npm run build

This command will create an optimized build in the .next folder.

Testing

Unit Tests (Vitest)

To run unit tests:

npm run test

End-to-End Tests (Playwright)

After installing the project dependencies, run the following command to install Playwright and its browser dependencies:

npm run playwright:install

To execute the E2E tests, use the following command:

npm run playwright:test

Linting & Formatting

To lint and format the code:

npm run lint
npm run format

Contributing

Feel free to submit issues or pull requests to improve the template. Ensure that you follow the coding standards and test your changes before submission.

License

This project is licensed under the MIT License. See the LICENSE file for details.