# Contributing to Vera

## Overview

We gratefully accept contributions to Vera, but expect new feature requests and changes to be discussed with Vera Design System team before [creating a pull request](https://github.com/Volue/vera/wiki/Contributing#pull-request).

If you have a question about the project, require support or have some generic idea for improvement, we have a discussion board on GitHub:

<Card
  href="https://github.com/Volue/vera/discussions"
  title="Start discussion"
  subTitle="Github discussions"
  actionIcon="externalLink"
/>

If you found any bugs in our components, it's best to report them on our GitHub issues board:

<Card
  href="https://github.com/Volue/vera/issues/new?labels=bug&template=bug_report.yml"
  title="Report bug"
  subTitle="GitHub issues"
  actionIcon="externalLink"
/>

If you have a proposal for a feature that is not yet available, you can describe it in detail and maybe use images to support it:

<Card
  href="https://github.com/Volue/vera/issues/new?labels=feature-request&template=feature_proposal.yml"
  title="Propose new feature"
  subTitle="GitHub issues"
  actionIcon="externalLink"
/>

## Adding components

Before creating a new component, please make sure something similar doesn’t already exist. We follow the below defined process to determine if we should extend an existing component, create a new component, or keep the component application specific instead.

We would be happy to spec out together with you how a new component could work and look.

## Dev setup

Vera Design System is divided into two main packages: `core` and `react`. Development for all of the packages happens inside one mono repository.

<Grid
  columns={{
    '@initial': '1',
    '@mqLargeAndUp': '2'
  }}
  columnGap="spacingL"
>
  <GridItem>
    <Card
      href="https://github.com/Volue/vera"
      title="Vera monorepo on GitHub"
      actionIcon="externalLink"
      img={require('@/assets/images/icons/github.svg')}
    />
  </GridItem>
</Grid>

Follow the steps in the [monorepo readme](https://github.com/Volue/vera#readme) to get the dev environment up and running.

## Developing components

For further advice on how to contribute new components, please refer to our contributing guide on the [Storybook website](https://next--698f15fa99e7b146f9002f64.chromatic.com).

<Grid
  columns={{
    '@initial': '1',
    '@mqLargeAndUp': '2'
  }}
  columnGap="spacingL"
>
  <GridItem>
    <Card
      href="https://next--698f15fa99e7b146f9002f64.chromatic.com/?path=/docs/getting-started-contributing-prerequisites--docs"
      title="Vera React contribution guides"
    />
  </GridItem>
</Grid>

## Time registration

You can officially register time spent on contributing to **Vera** as you would when developing other projects in Gemini Suite.

<Grid
  columns={{
    '@initial': '1',
    '@mqLargeAndUp': '2'
  }}
  columnGap="spacingL"
>
  <GridItem>
    <Card
      href="https://github.com/Volue/vera/wiki/Time-registration"
      title="Time registration guide"
    />
  </GridItem>
</Grid>