Skip to content

Latest commit

 

History

History
96 lines (68 loc) · 4.34 KB

CONTRIBUTING.md

File metadata and controls

96 lines (68 loc) · 4.34 KB
Raw

Contributing

:attention: In this CONTRIBUTING.md you read about contributing to this very repository. If you want to develop your own login UI, please refer to the README.md.

Introduction

Thank you for your interest about how to contribute!

:attention: If you notice a possible security vulnerability, please don't hesitate to disclose any concern by contacting [email protected]. You don't have to be perfectly sure about the nature of the vulnerability. We will give them a high priority and figure them out.

We also appreciate all your other ideas, thoughts and feedback and will take care of them as soon as possible. We love to discuss in an open space using GitHub issues, GitHub discussions in the core repo or in our chat on Discord. For private discussions, you have more contact options on our Website.

Pull Requests

Please consider the following guidelines when creating a pull request.

  • The latest changes are always in main, so please make your pull request against that branch.
  • pull requests should be raised for any change
  • Pull requests need approval of a ZITADEL core engineer @zitadel/engineers before merging
  • We use ESLint/Prettier for linting/formatting, so please run pnpm lint:fix before committing to make resolving conflicts easier (VSCode users, check out this ESLint extension and this Prettier extension to fix lint and formatting issues in development)
  • If you add new functionality, please provide the corresponding documentation as well and make it part of the pull request

Setting Up The ZITADEL API

If you want to have a one-liner to get you up and running, or if you want to develop against a ZITADEL API with the latest features, or even add changes to ZITADEL itself at the same time, you should develop against your local ZITADEL process. However, it might be easier to develop against your ZITADEL Cloud instance if you don't have docker installed or have limited resources on your local machine.

Developing Against Your Local ZITADEL Instance

# To have your service user key and environment file written with the correct ownership, export your current users ID.
export ZITADEL_DEV_UID="$(id -u)"

# Pull images
docker compose --file ./acceptance/docker-compose.yaml pull

# Run ZITADEL and configure ./apps/login/.env.local
docker compose --file ./acceptance/docker-compose.yaml run setup

# Configure your shell to use the environment variables written to ./apps/login/.env.acceptance
export $(cat ./apps/login/.env.acceptance | xargs)

Developing Against Your ZITADEL Cloud Instance

Configure your shell by exporting the following environment variables:

export ZITADEL_API_URL=<your cloud instance URL here>
export ZITADEL_ORG_ID=<your service accounts organization id here>
export ZITADEL_SERVICE_USER_TOKEN=<your service account personal access token here>

Setting up local environment

# Install dependencies. Developing requires Node.js v16
pnpm install

# Generate gRPC stubs
pnpm generate

# Start a local development server
pnpm dev

The application is now available at http://localhost:3000

Testing

You can execute the following commands pnpm test for a single test run or pnpm test:watch in the following directories:

  • apps/login
  • packages/zitadel-proto
  • packages/zitadel-client
  • packages/zitadel-node
  • The projects root directory: all tests in the project are executed

In apps/login, these commands also spin up the application and a ZITADEL gRPC API mock server to run integration tests using Cypress against them. If you want to run the integration tests standalone against an environment of your choice, navigate to ./apps/login, [configure your shell as you like](# Developing Against Your ZITADEL Cloud Instance) and run pnpm test:integration:run or pnpm test:integration:open. Then you need to lifecycle the mock process using the command pnpm mock or the more fine grained commands pnpm mock:build, pnpm mock:build:nocache, pnpm mock:run and pnpm mock:destroy.

That's it! 🎉