Reading the repo

Opening the box…

How to set up wp-calypso (Automattic/wp-calypso) · gitmanual

Assembly instructions

Automattic/wp-calypso

The JavaScript and API powered WordPress.com

Node.jsPHP#es2015#es6#es6-javascript#javascript

Difficulty: Moderate
Time: about 15 min
Stars: ★ 12,649
Activity: Updated this month
License: GPL-2.0
Open issues: 3,078
Got it running: Be the first
Looked up: 2 h ago

Saved setup from 2 h ago

Start here

Website ↗developer.wordpress.comThe project's own site.

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

Download for macOS

WP-Desktop 6.15.0 [updater redirect to wp-desktop repository] · 6/2/2021 ↗

wordpress.com-macOS-dmg-6.15.0-arm64.dmg

dmg · Apple Silicon · 113.1 MB · 113 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/Automattic/wp-calypso/releases/download/v6.15.0/wordpress.com-macOS-dmg-6.15.0-arm64.dmg"
open "wordpress.com-macOS-dmg-6.15.0-arm64.dmg"

Other macOS downloads (3)

wordpress.com-macOS-dmg-6.15.0.dmg

dmg · 112.3 MB · 67 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/Automattic/wp-calypso/releases/download/v6.15.0/wordpress.com-macOS-dmg-6.15.0.dmg"
open "wordpress.com-macOS-dmg-6.15.0.dmg"

wordpress.com-macOS-app-6.15.0-arm64.zip

zip · Apple Silicon · 110.8 MB · 99 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/Automattic/wp-calypso/releases/download/v6.15.0/wordpress.com-macOS-app-6.15.0-arm64.zip"
unzip "wordpress.com-macOS-app-6.15.0-arm64.zip"

wordpress.com-macOS-app-6.15.0.zip

zip · 110.2 MB · 20,045 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/Automattic/wp-calypso/releases/download/v6.15.0/wordpress.com-macOS-app-6.15.0.zip"
unzip "wordpress.com-macOS-app-6.15.0.zip"

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js 24.22.1runtime
1×PHP runtime
1×yarn yarn@4.0.2package manager
1×composer package manager

8× settings in .env

APP_STORE_CONNECT_API_KEY_KEY_IDsecret
APP_STORE_CONNECT_API_KEY_ISSUER_IDsecret
APP_STORE_CONNECT_API_KEY_KEYsecret
MATCH_PASSWORDsecret
MATCH_S3_ACCESS_KEYsecret
MATCH_S3_SECRET_ACCESS_KEYsecret
AGENT_API_BASE_URL
DEFAULT_PROXYoptional

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/Automattic/wp-calypso/badge.svg)](https://gitmanual.com/Automattic/wp-calypso)

Good to know

Monorepo (workspaces) — install from the repo root.
Dockerfile available (base image: node:${node_version}-trixie-slim).
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: .teamcity/pom.xml, apps/agents-manager/package.json, apps/blaze-dashboard/package.json, apps/happy-blocks/package.json and 11 more

package.json scripts (88)

analyze-bundlesyarn run build-client-stats && webpack-bundle-analyzer client/stats.json public/evergreen -h 127.0.0.1 -p 9898 -s gzip
analyze-bundles:serveryarn run build-server-stats && webpack-bundle-analyzer client/stats-server.json build -h 127.0.0.1 -p 9898 -s parsed
analyze-icfyyarn run build-client-stats && node --max-old-space-size=6144 bin/icfy-analyze.js
compare-icfynode bin/icfy-compare.js
build./bin/build-packages-if-needed.sh && yarn run build-static && yarn run build-css && run-p -s build-server build-client-if-prod
build-clientWORKERS=${WORKERS:-2} BROWSERSLIST_ENV=evergreen yarn webpack --config client/webpack.config.js --stats-preset errors-only
build-client-if-prodnode -e "process.env.CALYPSO_ENV === 'production' && process.exit(1)" || { run-p -s build-client translate-if-languages-enabled && yarn run build-languages-if-enabled }
build-client-statsNODE_ENV=production CALYPSO_ENV=production EMIT_STATS=true yarn run build-client
build-cssrun-p -s 'build-css:*'
build-css:reader-mobilenode bin/render-stylesheet.js --in client/assets/stylesheets/reader-mobile.scss --out public/reader-mobile.css && yarn run postcss public/reader-mobile.css
build-desktopcd desktop && yarn run build
build-desktop:appcd desktop && yarn run build
build-desktop:configcd desktop && yarn run build:config
build-dockernode bin/build-docker.js
build-languagesyarn run translate && node bin/build-languages.js
build-languages-if-enablednode -e "(process.env.BUILD_TRANSLATION_CHUNKS === 'true' || process.env.ENABLE_FEATURES === 'use-translation-chunks') && process.exit(1)" || node bin/build-languages.js
build-packages{ [ "${SKIP_TSC:-}" = "true" ] || tsc --build packages/tsconfig.json; } && yarn workspaces foreach --all --parallel --topological --verbose run prepare
build-packages:appsbash ./bin/build-packages-apps.sh
build-packages:unit-testsbash ./bin/build-packages-unit-tests.sh
build-packages:webbash ./bin/build-packages-web.sh
build-servermkdir -p build && BROWSERSLIST_ENV=server webpack --config client/webpack.config.node.js --stats-preset errors-only && yarn run build-server:copy-modules
build-server-statsNODE_ENV=production CALYPSO_ENV=production EMIT_STATS=true yarn run build-server
build-server:copy-modulesnode -e "process.env.CALYPSO_ENV === 'production' && process.exit(1)" || node bin/copy-production-modules.js
build-start./bin/build-packages-if-needed.sh && run-p -s build-static build-css build-server && yarn run build-client-if-prod
build-staticncp static public && ncp client/lib/service-worker public --filter='service-worker(/service-worker\.js)?$'

Files we read (14)

.github/workflows/a4a-pr-review.yml

.github/workflows/apply-stale-closure-label.yml

.github/workflows/calypso-live.yml

.github/workflows/claude.yml

.github/workflows/codeql-analysis.yml

.github/workflows/dashboard-pr-review.yml

.nvmrc

Dockerfile

README.md

composer.json

desktop/fastlane/example.env

docs/install.md

package.json

packages/agenttic-client/.env.example

Branch trunk · 24,464 files in the repo