Porsche Design System

The all-in-one toolkit for creating high-quality, visually stunning Porsche web applications — featuring design tokens, robust web components and comprehensive guidelines. It's built and tested to embody Porsche’s signature quality and design principles.

Build status

Getting started

Tools

Volta

We recommend using Volta to manage the correct Node.js and NPM version.

# On most Unix systems including macOS, you can install with a single command:
curl https://get.volta.sh | bash

Node

volta install node@24

# Verify the Node.js version:
node -v

Volta should automatically pick up the correct Node.js version defined in ./package.json.

Docker

Using Docker is optional but recommended for test automation, as it ensures consistent results across different machines. This is particularly important for visual regression testing.

1. Register your Docker account on Hub-Docker
2. Download Docker app locally on your machine and login
3. Start Docker

---

Installation

node_modules

Install all required npm packages:

npm install

Build all internal npm packages:

npm run build

---

Setup

The following instructions assume that WebStorm is used as the IDE.

Prettier (Formatter)

1. Go to WebStorm Preferences
2. In Preferences go to Languages and Frameworks -> Javascript -> Prettier
3. Activate Automatic Prettier configuration
4. Change Run for files to {**/*,*}.{md,mdx}
5. Click checkbox Run on save and apply

Note: If you have to exclude code fom being prettified, see Prettier configuration

Biome (Formatter + Linter)

1. Go to WebStorm Preferences
2. Click on the Plugins tab and search for biome
3. Install Biome
4. In Preferences go to Languages and Frameworks -> Biome
5. Activate Automatic Biome configuration
6. Change Supported extensions to .astro,.css,.gql,.graphql,.js,.mjs,.cjs,.jsx,.json,.jsonc,.svelte,.html,.ts,.mts,.cts,.tsx,.vue
7. Click checkbox Run format on save, Run safe fixes on save, Sort import on save and apply

Note: If you have to exclude code fom being formatted or linted, see Biome configuration

---

Commands

All available commands for developing, building and testing are listed in the scripts section of the ./package.json file in the project root. You can execute them from the root directory, for example:

• npm run build
• npm run test:e2e:components-js
• npm run test:vrt:components-js
• …

Any command can also be executed in a Docker container by running it with ./docker.sh, such as:

• ./docker.sh npm run build
• ./docker.sh npm run test:e2e:components-js
• ./docker.sh npm run test:vrt:components-js
• …