Frontend contribution guidelines

To work on most frontend issues, it is necessary to run three applications locally:

1. The web app in the client/web directory.
2. Storybook (client/storybook)
3. The browser extension (client/browser)

Project Setup

1. Clone the repo: git clone https://github.com/sourcegraph/sourcegraph/.
2. Make sure your node environment is running version 16.x.x.
3. Go through the local development section here.

CI checks to run locally

1. Typescript checks.

   # Generate Typescript types
   pnpm generate
   
   # Verify Typescript build
   pnpm build-ts
   

   1. Linters. sh pnpm lint:js:all pnpm lint:css:all pnpm lint:graphql pnpm format:check

2. Unit tests

   # Run unit tests
   pnpm test
   

   1. Integration tests

      # Prepare web application for integration tests
      ENTERPRISE=1 DISABLE_TYPECHECKING=true pnpm run build-web
      # Run integration tests
      pnpm test-integration
      

Relevant development docs

Getting applications up and running

• Developing the Sourcegraph web app
• Table of contents related to the web app
• Configuring backend services locally is not required for most frontend issues. However, a guide on how to do this can be found here.

How to style UI

• Guidelines
• Wildcard Component Library

Client packages overview