From 1532b07ec8b35b5601b62a06cb2808e7355cbc2d Mon Sep 17 00:00:00 2001 From: Salma Alam-Naylor Date: Tue, 3 Feb 2026 13:17:59 +0000 Subject: [PATCH 1/9] Update contributing --- CONTRIBUTING.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8f5867e976..af7997e7cf 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -8,11 +8,16 @@ Thank you for your interest in contributing! ❤️ This document provides guide ## Goals -We want to create 'a fast, modern browser for the npm registry.' This means, among other things: +The goal of [npmx.dev](https://npmx.dev) is to build a fast, modern browser for the npm registry. -- We don't aim to replace the [npmjs.com](https://www.npmjs.com/) registry, just provide a better UI and DX. -- Layout shift, flakiness, slowness is The Worst. We need to continually iterate to create the most performant, best DX possible. -- We want to provide information in the best way. We don't want noise, cluttered display, or confusing UI. If in doubt: choose simplicity. +We're not replacing the [npmjs.com](https://www.npmjs.com/) registry, but instead providing an elevated developer experience through a fast, modern UI. + +What npmx offers: + +- **Speed** – Fast searching, filtering, and navigation. +- **Simplicity** – Get the information you need when you need it in an intuitive UI. +- **Compatibility** – Replace `npmjs.com` with `xnpmjs.com` or `npmx.dev` in any URL and it just works. +- **Enhanced admin experience** – Manage your packages, teams, and organizations from the browser, powered by your local npm CLI. ## Table of Contents @@ -148,6 +153,10 @@ To help with this, the project uses `oxfmt` to handle formatting via a pre-commi If you want to get ahead of any formatting issues, you can also run `pnpm lint:fix` before committing to fix formatting across the whole project. +### npmx name + +If adding the name of the project to anywhere in the UI, use `npmx` in all lowercase letters. + ### TypeScript - We care about good types – never cast things to `any` 💪 From 0ce152d5b6fe8b3a961d8674d1fd50d0a0ad5041 Mon Sep 17 00:00:00 2001 From: Salma Alam-Naylor Date: Tue, 3 Feb 2026 13:18:47 +0000 Subject: [PATCH 2/9] Update word --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index af7997e7cf..eb1c297cd4 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -155,7 +155,7 @@ If you want to get ahead of any formatting issues, you can also run `pnpm lint:f ### npmx name -If adding the name of the project to anywhere in the UI, use `npmx` in all lowercase letters. +When adding the name of the project to anywhere in the UI, use `npmx` in all lowercase letters. ### TypeScript From 8cb73308f5b8de79bdd5ce56add6b7d36bef6d91 Mon Sep 17 00:00:00 2001 From: Salma Alam-Naylor Date: Tue, 3 Feb 2026 13:26:48 +0000 Subject: [PATCH 3/9] Clarify URL compatibility --- CONTRIBUTING.md | 2 +- README.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index eb1c297cd4..bec78838ac 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -16,7 +16,7 @@ What npmx offers: - **Speed** – Fast searching, filtering, and navigation. - **Simplicity** – Get the information you need when you need it in an intuitive UI. -- **Compatibility** – Replace `npmjs.com` with `xnpmjs.com` or `npmx.dev` in any URL and it just works. +- **URL Compatibility** – Replace `npmjs.com` with `xnpmjs.com` or `npmx.dev` in any URL and it just works. - **Enhanced admin experience** – Manage your packages, teams, and organizations from the browser, powered by your local npm CLI. ## Table of Contents diff --git a/README.md b/README.md index 1a421dc976..9aa87240d0 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,7 @@ What npmx offers: - **Speed** – Fast searching, filtering, and navigation. - **Simplicity** – Get the information you need when you need it in an intuitive UI. -- **Compatibility** – Replace `npmjs.com` with `xnpmjs.com` or `npmx.dev` in any URL and it just works. +- **URL Compatibility** – Replace `npmjs.com` with `xnpmjs.com` or `npmx.dev` in any URL and it just works. - **Enhanced admin experience** – Manage your packages, teams, and organizations from the browser, powered by your local npm CLI. ## Shortcuts From fafefa2db6b85a2e8c4a2373e7d6e7b6181164a9 Mon Sep 17 00:00:00 2001 From: Salma Alam-Naylor Date: Tue, 3 Feb 2026 13:27:54 +0000 Subject: [PATCH 4/9] Update mentions of npm --- CONTRIBUTING.md | 2 +- README.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bec78838ac..977925795e 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -10,7 +10,7 @@ Thank you for your interest in contributing! ❤️ This document provides guide The goal of [npmx.dev](https://npmx.dev) is to build a fast, modern browser for the npm registry. -We're not replacing the [npmjs.com](https://www.npmjs.com/) registry, but instead providing an elevated developer experience through a fast, modern UI. +We're not replacing the [npm](https://www.npmjs.com/) registry, but instead providing an elevated developer experience through a fast, modern UI. What npmx offers: diff --git a/README.md b/README.md index 9aa87240d0..04ddf9c181 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ The goal of [npmx.dev](https://npmx.dev) is to build a fast, modern browser for the npm registry. -We're not replacing the [npmjs.com](https://www.npmjs.com/) registry, but instead providing an elevated developer experience through a fast, modern UI. +We're not replacing the [npm](https://www.npmjs.com/) registry, but instead providing an elevated developer experience through a fast, modern UI. What npmx offers: From feabfdb13f70f7278698a16a6c137ab4c401696d Mon Sep 17 00:00:00 2001 From: Salma Alam-Naylor Date: Tue, 3 Feb 2026 13:53:23 +0000 Subject: [PATCH 5/9] Update contributing --- CONTRIBUTING.md | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 977925795e..fcd2b9668d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -8,16 +8,13 @@ Thank you for your interest in contributing! ❤️ This document provides guide ## Goals -The goal of [npmx.dev](https://npmx.dev) is to build a fast, modern browser for the npm registry. +The goal of [npmx.dev](https://npmx.dev) is to build a fast, modern and open-source browser for the npm registry, prioritizing speed, simplicity and a community-driven developer experience. -We're not replacing the [npm](https://www.npmjs.com/) registry, but instead providing an elevated developer experience through a fast, modern UI. +### Core values -What npmx offers: - -- **Speed** – Fast searching, filtering, and navigation. -- **Simplicity** – Get the information you need when you need it in an intuitive UI. -- **URL Compatibility** – Replace `npmjs.com` with `xnpmjs.com` or `npmx.dev` in any URL and it just works. -- **Enhanced admin experience** – Manage your packages, teams, and organizations from the browser, powered by your local npm CLI. +- Speed +- Simplicity +- Community-first ## Table of Contents From a1c0b65689a0668838d97d9acaa7bf65a8525f30 Mon Sep 17 00:00:00 2001 From: Salma Alam-Naylor Date: Tue, 3 Feb 2026 14:00:45 +0000 Subject: [PATCH 6/9] coderabbit suggestion --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index fcd2b9668d..e191ddcc0a 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -152,7 +152,7 @@ If you want to get ahead of any formatting issues, you can also run `pnpm lint:f ### npmx name -When adding the name of the project to anywhere in the UI, use `npmx` in all lowercase letters. +When displaying the project name anywhere in the UI, use `npmx` in all lowercase letters. ### TypeScript From 3314778b18e7b235b25523e31e30d74b65344344 Mon Sep 17 00:00:00 2001 From: Salma Alam-Naylor Date: Tue, 3 Feb 2026 14:29:01 +0000 Subject: [PATCH 7/9] Add target audience --- CONTRIBUTING.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e191ddcc0a..1dff2d3ee1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -16,6 +16,12 @@ The goal of [npmx.dev](https://npmx.dev) is to build a fast, modern and open-sou - Simplicity - Community-first +### Target audience + +We're building npmx primarily for **package maintainers**. This means putting a focus on building the tools and capabilities that prioritise the needs of maintainers over consumers of packages. + +Designing and building npmx for this audience helps us to decide what features to build, and what features to deprioritize. + ## Table of Contents - [Getting started](#getting-started) From b0ee7a40fbbf8149b33f2a95fc946ceaf51d55c8 Mon Sep 17 00:00:00 2001 From: Salma Alam-Naylor Date: Tue, 3 Feb 2026 14:35:19 +0000 Subject: [PATCH 8/9] fix spelling --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1dff2d3ee1..a82f2214cc 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -18,7 +18,7 @@ The goal of [npmx.dev](https://npmx.dev) is to build a fast, modern and open-sou ### Target audience -We're building npmx primarily for **package maintainers**. This means putting a focus on building the tools and capabilities that prioritise the needs of maintainers over consumers of packages. +We're building npmx primarily for **package maintainers**. This means putting a focus on building the tools and capabilities that prioritize the needs of maintainers over consumers of packages. Designing and building npmx for this audience helps us to decide what features to build, and what features to deprioritize. From ee552c789c8bc12a144e048dc620de2579d26c3e Mon Sep 17 00:00:00 2001 From: Salma Alam-Naylor Date: Tue, 3 Feb 2026 18:19:07 +0000 Subject: [PATCH 9/9] Update target audience --- CONTRIBUTING.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a82f2214cc..8819f243d1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -18,9 +18,11 @@ The goal of [npmx.dev](https://npmx.dev) is to build a fast, modern and open-sou ### Target audience -We're building npmx primarily for **package maintainers**. This means putting a focus on building the tools and capabilities that prioritize the needs of maintainers over consumers of packages. +npmx is built for open-source developers, by open-source developers. -Designing and building npmx for this audience helps us to decide what features to build, and what features to deprioritize. +Our goal is to create tools and capabilities that solve real problems for package maintainers and power users, while also providing a great developer experience for everyone who works in the JavaScript ecosystem. + +This focus helps guide our project decisions as a community and what we choose to build. ## Table of Contents