What is ethereum-org-website?

ethereum/ethereum-org-website — explained in plain English

Analysis updated 2026-06-26

★ 5,926MarkdownAudience · developerComplexity · 3/5Setup · moderate

Mindmap

mindmap
  root((repo))
    What it is
      Ethereum info site
      Community portal
      Not the blockchain
    Tech
      Next.js and React
      TypeScript
      pnpm
    Contributions
      Content edits
      Bug reports
      Translations
    Workflow
      Fork and PR
      Netlify preview
      Dev branch

mindmap root((repo)) What it is Ethereum info site Community portal Not the blockchain Tech Next.js and React TypeScript pnpm Contributions Content edits Bug reports Translations Workflow Fork and PR Netlify preview Dev branch

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Contribute written explanations or code examples to ethereum.org to help newcomers understand Ethereum.

USE CASE 2

Translate ethereum.org pages into another language using Crowdin without writing any code.

USE CASE 3

Study how a large-scale Next.js and React website handles multilingual content and open-source contributions.

What is it built with?

Next.jsReactTypeScriptpnpmCrowdinNetlify

How does it compare?

	ethereum/ethereum-org-website	rust-lang/rfcs	missing-semester-cn/missing-semester-cn.github.io
Stars	5,926	6,487	7,240
Language	Markdown	Markdown	Markdown
Setup difficulty	moderate	easy	easy
Complexity	3/5	1/5	1/5
Audience	developer	developer	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires pnpm and environment variable configuration, build with a subset of languages to avoid slow build times.

So what is it?

This repository contains the source code for ethereum.org, the main informational website for the Ethereum blockchain. The site describes itself as a portal for the Ethereum community, aimed at explaining what Ethereum is, how it works, and how to build on it. It is maintained by the Ethereum Foundation and by community contributors around the world. It is worth noting that this repository is the website only, not the Ethereum blockchain itself. Ethereum has no single codebase, as there are multiple independent software clients that implement the protocol in different programming languages. The website links to those separately. The site is built with Next.js and React, and uses TypeScript. It also supports dozens of languages through a translation program hosted on Crowdin, where volunteers can contribute translations without writing code. The project tracks all types of contributions, including content edits, bug reports, and translations, using a tool called all-contributors. Contributing to the site follows a standard open-source workflow: file an issue to describe what you want to change, fork the repository, make your changes locally with pnpm as the package manager, and open a pull request against the dev branch. The project uses Netlify to generate a live preview of every pull request, so reviewers can see proposed changes on an actual website before they are merged. The README itself is extremely detailed and covers local environment setup, environment variable configuration, branch management, and tips for building only a subset of languages to speed up development. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1

I want to add a new page to ethereum.org explaining a specific Ethereum concept. Walk me through the Next.js and Markdown file structure I need to follow.

Prompt 2

Help me set up the ethereum-org-website repo locally using pnpm and show me how to build only English pages to speed up development.

Prompt 3

I want to fix a typo on ethereum.org, show me how to fork the repo, make the edit, and open a pull request against the dev branch.

Prompt 4

Generate a Crowdin-friendly Spanish translation of an English ethereum.org section, keeping all Markdown links intact.

Frequently asked questions