Privacy Stewards of Ethereum

Enhancing Ethereum through cryptographic research and collective experimentation.

Contributing guidelines

Open for contribution.

• For adding new features, please open PR and first merge to staging/dev for QA, or open issue for suggestion, bug report.
• For any misc. update such as typo, PR to main and two approval is needed.

Add/Edit article

• For updating/adding a new article you can follow this guide

Add/Edit project list

• For updating/adding project detail you can follow this guide

PR Review process

For internal, PSE member:

• Suggest to tag: @wslyvh, @psedesign, andyguzmaneth for PR review.
• If question, please reach out in discord channel #website-pse

For external:

• Translation PR: please tag a member you know that can help review your translation
• Any type of PR: please state clear your intention For any suggestion, feel free to open issue or send us a message on Discord #suggestion

Run Locally

Clone the project

  git clone https://github.com/privacy-ethereum/pse.dev

Go to the project directory

  cd pse.dev

Install dependencies

  yarn

Start the app

  yarn dev

Tech Stack

@shadcn's Nextjs 13 template

• Next.js 14 App Directory
• Radix UI Primitives
• Tailwind CSS
• Icons from Lucide
• Tailwind CSS class sorting, merging and linting.

Testing

Quick commands:

# Run all tests (CI mode)
yarn test:run

# Watch mode (dev)
yarn test:watch

# UI runner
yarn test:ui

# Coverage report
yarn test:coverage

# Validate setup (sanity checks)
yarn test:validation

Notes:

• Tests live in tests/ with utilities in tests/test-utils.tsx.
• Mocks are under tests/mocks/ (Next components, browser APIs, external libs).
• Use the custom render from @/tests/test-utils to get providers.
• Path alias @/ points to project root.
• jsdom environment is preconfigured.