The JavaScript and API powered WordPress.com
Switch branches/tags
a/b-test-distributionbump abtest/resume-gsuite-upsell-discount-test add/activity-loading-filterbar add/activity-log-aggregate-events add/billing-info-to-checkout add/bulk-module-management add/call-endpoint-on-nudge-click add/checklist-tests add/color-studio-package add/community-events add/connect-site-topic-redux-state add/contact-form-tranform-from add/ebanx-installments add/ecommerce-signup-updates add/error-no-noticeid add/eslint-packages add/exclude-steps-from-flow add/export-media add/facebook-profile-connection-failure-events add/fetch-language-revision-map add/fix-filterbar-return-to-first-page add/form-fields-comprehensive-validation-examples add/google-ads-gtag-cleanup add/google-photos-date-filter add/google-photos-folder-dropdown add/gsuite-business add/gutenberg-contextual-help-actions add/gutenberg-e2e add/gutenberg-simple-payments-block-media-library-integration add/happychat-client-events add/happychat-client-to-mobile add/happychat-panel add/i18n-calypso-import add/i18n-load-gutenberg-translations add/i18n-repo-take-two add/import-signup-auto-continue add/import-url-to-ays add/is-ecommerce-plan-user-selector add/jetpack-asset-CDN-setting-toggle add/jetpack-branding-checkout add/jetpack-branding-plans-grid add/jetpack-importing add/jetpack-module-override add/jetpack-setup-skeleton add/krackenreboot327-abtest add/let-jetpack-use-geolocation add/localized-support-urls-inline-contextual-help add/login-screen-sign-up-option add/manage-u2f-keys add/mobile-app-attribution-links add/nested-sidebar add/oct-promo-email-nudge-and-banner add/onboarding-site-style-step-redux-state add/onboarding-site-style-step add/onboarding-step-site-information-component add/onboarding-step-site-information add/package-photon add/payment-type-sofort add/pending-payment-blocker add/personality-to-signup-color add/personality-to-signup-layout add/personality-to-signup-testimonials add/personality-to-signup add/phone-to-concierge add/plans-page-add-renewing-upsell-banner add/query-component add/recent-renewals-to-checkout-2 add/recipes-block add/remembered-posts add/return-site-event add/rewind/clone-site-events add/select-dropdown-add-disabled-state add/separate-login add/settings-sub-sidebar add/signup-import-landing-handler--pass-url-to-import-section--skip-unhydrated add/signup-import-landing-handler--validation--confirmation-step add/signup-import-new-site-param add/site-impoter-engine-6 add/site-mockup add/small-badge add/store-referrers-2nd-try add/store-return-shipping-labels add/store-stats-referrer-conv-widget add/store-tracking-number-copy-to-clipboard add/tracks-events-for-email-task-in-onboarding-checklist add/u2f-login-ui add/user-purchases-data-layer add/view-site-happychat-updates add/wcs-shipping-classes-field add/with-woo-commerce-site add/woocommerce-shipping-classes-ui add/woocommerce/calypsoify-menu-item atavist/add-hello-test atavist/all-blocks atavist/baseline atavist/block-structure atavist/chart-block atavist/map-block-api-key-integration atavist/map-block-center-point atavist/map-block-themepicker-v2 atavist/map-block-v2 atavist/map-block atavist/navigation-flag atavist/simplified-structure atavist/starter-block atavist/title-design contact-form-change-submit-text earn-section enable/happychat-client-panel enhance/remove-page-refresh-after-changing-language experiment/add-dummy-redux-counter feature/blogger-plan/block-domain-transfer feature/blogger-plan/cancel-purchase-form feature/blogger-plan/constants feature/blogger-plan/domain-search-p2 feature/blogger-plan/domain-search feature/blogger-plan/prepare-plans-pages feature/monthly-business-plan-implement feature/monthly-business-plan-tests feature/monthly-business-plan fix/activity-log-double-ellipsis fix/allow-renewal-of-business-on-expired-atomic fix/block-editor-redirect fix/calypsoify-plugin-link fix/change-store-theme fix/checklist/disable-guided-tour-for-gutenberg fix/checkout-tests-warnings fix/current-plan-error fix/debug-g7g-controller fix/editor-scroll-jump fix/editor-slug-invalid-chars-ays fix/emergent-wpcom-error-handling fix/external-media-limits fix/google-my-business-fetch-services fix/google-photos-recent-limit fix/gutenberg-classic-block fix/gutenberg-notice-styling fix/gutenberg-unsaved-warning fix/i18n-schedule-concierge-session fix/imorter-wix-site-preview-flicker fix/improve-plans-features-header-performance-in-signup fix/inline-articles-buttons-on-small-screens fix/jetpack-double-cta fix/libuser/checkout-thank-you fix/map-persisted-map-center fix/media-library-disable-video-icon fix/my-sites-styles fix/nan-check-in-simple-payments fix/postschedule-select-button-22966 fix/publicize-gutenberg-connection-list-calypso fix/reader/duplicate-x-post-blogs fix/reader/poll-fm-polls fix/reader/update-post-normalizer-polls fix/rewind/awaiting-credentials fix/route-mismatch fix/send-english-site-topic fix/signup-import-site-validation fix/simple-payments-reusable fix/site-importer-console-errors fix/tel-input-pattern fix/translation-function-typo fix/wcs-1274-order-tracking-settings fix/wrong-pathname fix/1170-handle-failed-downloads fix/7969-meta-description-notice fix/20250/simple-payments-dialog-upgrade-nudge fix/26051-purchase-confirmation-widow fix/27051-acitivity-log-doc-links fix/28818-g7g-simplepay-edit-currencyformat gb/sketch-a-doodle gutenpack-subscription improve/chart-component-performance-2 improve/chart-component-performance-3 improve/google-my-business-chart-tooltip-screentext improve/language-js-as-utf8 login_url mailchimp-gutenberg-block mailchimp master nudge-a-palooza/wrap-up-landing-pages nudge-a-palooza/wrap-up-sidebar-banner-test nudge-a-palooza/wrap-up-themes-nudges-updates packages/extract-http-data perf/move-cart-store-out-of-build-chunk prettify/account-recovery publish/try-again refactor/async-load-charts refactor/gsuite-domains-select refactor/stats-chart-request-parallelization-redo refactor/stats-chart-tabs-derived-state refactor/stats-chart-tabs refactor/stats-post-summary release/desktop/3.7.0 release/desktop/3.8.0 remove/aol-tracking-pixel remove/boot-empty-layout remove/dispatch-converter-2 remove/document-head-unread-count remove/ecommerce-prod remove/g7g-tg-redundant-fragment remove/global-notice-block remove/gpack-relatedposts-center-content remove/happychat-current-message remove/happychat-redux-minimize remove/happychat-timeline remove/jetpack-plugin-on-pages remove/weak remove/wp-job-manager rename/preset-o2-to-p2 renovate/clipboard-2.x renovate/core-js-2.x renovate/creditcards-3.x renovate/d3-array-2.x renovate/enzyme-to-json-3.x renovate/eslint-config-prettier-3.x renovate/eslint-plugin-jest-22.x renovate/html-to-react-1.x renovate/husky-1.x renovate/marked-0.x renovate/nock-10.x renovate/node-10.x renovate/page-1.x renovate/react-redux-5.x renovate/sinon-chai-3.x renovate/socket.io-2.x renovate/striptags-3.x renovate/superagent-4.x renovate/tinymce-4.x renovate/yargs-12.x revert-27174-revert-26006-fix/stats-referrers-layout revert-28603-update/login-signup-redirect-for-crowdsignal revert-28620-remove/private-by-default revert-28752-update/blocks-svg-accessibility revert/remote-login signup/remove-domain-step stash/tax-on-plans-screen subscriptions-block-two test/full-suite-reruns testing/signup-and-hash-branches testing/webpack-build-timestamping-desktop-tests testing/webpack-build-versioning tests/add-editor-path-tests try/add-new-site-popover try/allow-facebook-profile-publish try/async-load-inline-help try/async-load-so-many-things try/async-payments try/async-reducers try/babel-plugin-i18n-calypso try/chart try/circle-massive-parallel try/desktop-improve-app-preferences-experience try/devdocs-example-embeds try/docker/explicity-copy try/es-next-uglification try/flexible-bottom-right-buttons--bu try/flexible-bottom-right-buttons--env-badge try/flexible-bottom-right-buttons try/gutenberg-clean-state try/gutenberg-force-reload try/gutenberg-publish try/gutenblock-build-external-dependencies try/happychat-client try/hoist-lerna try/jpc-request-site-action try/live-preview try/load-calypso-offline try/map-all+loader try/map-all try/map-block-mapbox-css try/map-block-mapbox try/map-key try/map try/marketing-checklist try/massiver-circleci try/material-hacky-checkbox try/memberships try/move-nps-survey-to-data-layer try/muriel-in-devdocs try/new-colors try/pbd-for-import-signup-flow try/portenblocks try/private-by-default try/pwa try/react-material-wrapper try/recovery-lookup-handlers try/redux-cart try/remove-masterbar-componentize-header try/remove-masterbar-duplicate-logo-animated try/remove-masterbar-from-signup try/remove-masterbar-via-controller try/replace-gutencomponents-with-calypsomponents try/replace-oauth-login-for-desktop try/rewind-staging try/sdk-mini-css try/show-loading-signup try/signup-business-site-setup try/simple-payment-block try/simplify-add-new-site try/slideshow try/split-builds-by-ua try/split-posts-pages-section try/store-services-visual-box-packing-steps try/store_clone_destination try/suggestion-search-limit try/table-driven-cart-total try/tiled-gallery-block try/updated-signup-steps try/user-first-signup-test try/wp-data-calypso-plugin try/wp-data-calypso-rewrite try/wp-data-dynamic-state tweak/webpack-build-timestamping update/activity-log-fetches-plugin-updates update/activity-upgrade-nudge update/activitylog-filterbar-in-production update/add-button-disabled-props-to-action-card update/add-plugin-link update/always-set-locale-in-login-route update/analytics-environment-super-props update/badge-styles update/banner/use-css-vars update/blocks/basic-color-vars update/blogger-plan-cosmetic-updates update/bring-hint-data-to-site-topic update/browser-support update/calypsoify-rollout-50 update/checklist-redux-janitorial update/circle-parallelism update/color-schemes/sidebar-masterbar update/comments-bulk-status update/comments-edit-dispatch-request update/concierge-session-messaging update/conclude-showPlanCreditsApplied update/conditionally-register-publicize-plugin update/consolidate-site-topic-submission update/contact-form-block-email-placeholder update/count-styles update/coupon-field-more-visible update/credit-card-list-item-into-reusable-component update/credit-card-lists-to-use-credit-card-component update/data-layer-site-settings update/datalayer/mute-conversation update/datalayer/posts-comments-write-reply update/datalayer/request-recommended-sites-fromApi update/desktop-user update/domain-mapping-price-formatting update/domain-transfer-price-formatting update/ecommerce-in-components update/ecommerce-thank-you update/email-support-desc update/enable-checklist-all-envs update/enable-nudge-a-palooza-in-wp-calypso update/environment-badge update/extract-happychat-connection update/fix-jetpack-connect-nux-css update/fix-plan-preview-nudge-underline update/fix-subscription-length-picker update/form-block-icon-color update/give-options-when-customer-has-1-1-appointment update/google-my-business-styles-to-webpack update/gsuite-availability update/gsuite-country-blocks update/gutenber-block-with-jetpack-prefix update/gutenberg-packages update/gutenberg-publicize-use-dashicon update/gutenberg-simplepay-tofromapi update/gutenpack-simplepayments-filters update/i18n-calypso-cleanup update/i18n-links update/import-done-link-to-checklist update/import-flow--do-import update/importer-store-redux--make-actions-hybrid-2 update/importer-store-redux--make-actions-hybrid update/importer-store-redux update/imports-use-ui-state-to-show-selected-pane--remove-local-id update/imports-use-ui-state-to-show-selected-pane--x--x update/improve-infinite-list-perf update/improve-uploading-plugin-notice update/inline-help-extra-UI update/inline-help/add-support-articles update/inline-help/use-happychat-client update/jetpack-blocks-68 update/jetpack-connect-page-localization update/jetpack-connect-start-free-button-position update/jetpack-preset-block.json update/jetpack-thank-you-card update/jetpack-wp-data update/jpc-sso-shared-error update/jpc-user-already-connected-error-use-middleware update/mailchimp-choose-none update/map-block-fix-visibility update/map-block-remove-paragraphs update/map-block-use-local-date-in-view update/map-cleanup update/me-purchases-data-layer update/me/billing-history/add-tax update/me/css-vars update/me/purchases/add-tax update/media-library-accessibility update/media-library-list-loading-placeholders update/media-library-moving-to-redux update/memberships-one-time-payment update/migrate-media-styles update/migrate-styles-calendar-button update/migrate-users-store-2 update/move-importers-upload-state-to-redux update/move-krackenm327-from-domains-add-to-domains-start update/my-sites/css-vars update/no-anchored-sdk-paths update/no-hardcoded-free-sites-selector update/no-hardcoded-site-id-selector update/no-site-dep-purchase__backup update/notifications-2-1-10 update/onboarding-inline-help-popup update/onboarding-redirect-to-preview update/phone-validation update/plans-domain-credit-wording update/plans-features-taglines update/plans-features update/popular-plan update/post-editor-styles update/post-editor/css-vars update/post-item-form-checkbox update/prefill-site-type-from-query-arg update/prettier-notifications update/query-user-purchases update/reader-streams-refactor-pending-items update/recent-post-views-data update/refactor-notifications-toggle-state--redux update/refactor-notifications-toggle-state update/remove-ecommerce-plan update/replace-anchors-with-buttons-on-transfer-screen update/root-deps-to-dev-deps update/set-default-plans-tab update/shallow-gp-checkout update/show-discount-separately-in-checkout update/show-taxes-on-checkout-cart-take-2 update/show-taxes-on-checkout-cart update/show-usd-symbol update/signup-hightlight-business-plan update/simple-payments-block-featured-media-view update/simple-payments-block-formik update/site-indicator-links-to-activity-log update/site-topic-search update/site-topic-step-to-use-verticals-api update/stats-list-styles update/store-email-settings-data-layer update/store-product-reviews-api update/subscription-length-picker-manual-renew update/todo-block-fixes update/traffic-settings-subsection-redirect update/transfers-latest-dispatch update/upgrade-credits-copy update/upsell-page-design update/use-flow-destination update/woocomerce-shipping-zones-selectors update/woocommerce/data-layer/review-replies update/woocommerce/data-layer/reviews update/wp-job-manager-dispatch-request update/28202-general-changes-primary-domain-explanation web-payment-fix-country-zip wip/guided-tours-refactor
Nothing to show
Clone or download
flootr Reader: update color names to use css vars (#29064)
* reader: replace sass var '$blue-wordpress' with css var '--color-primary'

* reader: replace sass var '$blue-medium' with css var '--color-accent'

* reader: replace sass var '$blue-light' with css var '--color-primary-light'

* reader: replace sass var '$blue-dark' with css var '--color-primary-dark'

* reader: replace sass var '$alert-green' with css var '--color-success'
Latest commit af76bb0 Dec 10, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Monorepo: Enable lerna, add the root to the lerna config (#29154) Dec 6, 2018
.github remove 'beta' note from pr template (#27520) Oct 2, 2018
assets/stylesheets refactor: run prettier on all sass files in /assets (#29164) Dec 6, 2018
bin Monorepo: Enable lerna, add the root to the lerna config (#29154) Dec 6, 2018
client Reader: update color names to use css vars (#29064) Dec 10, 2018
config Gutenlypso: Enable Jetpack Blocks (#29080) Dec 7, 2018
docs SDK: Extern lodash for Gutenberg (#28559) Nov 16, 2018
packages Packages: Use 2 spaces for tree-select package.json (#29225) Dec 7, 2018
public Color schemes: Updating images for scheme switcher (#29204) Dec 10, 2018
server Refactor sections route handler to support async init functions (#28301) Nov 22, 2018
test Packages: Improve setup (#29137) Dec 5, 2018
.dockerignore Build: Remove tests from Docker build context (#22220) Feb 16, 2018
.editorconfig Editorconfig: package.json and yaml files should use spaces (#29222) Dec 7, 2018
.eslines.json Never ignore undef errors. (#26528) Aug 7, 2018
.eslintignore Packages: Improve setup (#29137) Dec 5, 2018
.eslintrc.js Eslint: consolidate configs to one file (#28827) Nov 26, 2018
.gitattributes GitHub: Use JSX syntax highlighting for *.js (#28459) Nov 12, 2018
.gitignore Monorepo: Enable lerna, add the root to the lerna config (#29154) Dec 6, 2018
.npmrc Update to Node 10 (10.4.0) and npm 6.1.0 (#25374) Jun 11, 2018
.nvmrc Update Node.js to v10.14.0 Nov 29, 2018
.postcssrc.json Update dependency postcss-custom-properties to v7 (#25995) Jul 13, 2018
.prettierrc Upgrade Prettier to 1.13.5 and add a config file Jun 12, 2018
.rtlcssrc i18n: Update RTLCSS to 2.0.5 (#5440) May 26, 2016
.stylelintrc Add parentheses spacing stylelint rules Jul 31, 2018
CODE-OF-CONDUCT.md update link Sep 11, 2017
CREDITS.md Remove Olark (#21488) Jan 16, 2018
Dockerfile Monorepo: Enable lerna, add the root to the lerna config (#29154) Dec 6, 2018
LICENSE.md Initial commit of wp-calypso Nov 20, 2015
README.md Readme: add links to 'Getting Started' for node, npm and git (#26408) Jul 31, 2018
Vagrantfile Initial commit of wp-calypso Nov 20, 2015
Vagrantfile-boot2docker Initial commit of wp-calypso Nov 20, 2015
babel.config.js Activate use of Babel Plugins for translatable string extraction on t… Nov 27, 2018
cached-requests.json Offline: Add default empty cached requests file (#20934) Dec 19, 2017
env-config.sh Build: Include a default env-config.sh (#20691) Dec 13, 2017
index.js Framework: Better babel config for node (#25830) Oct 29, 2018
inline-imports.js Avoid using path.skip() in the Babel transform for action type inlining Jul 11, 2018
jsconfig.json jsconfig: Add further jsconfig excludes according to latest Microsoft… Jan 10, 2018
lerna.json Monorepo: Enable lerna, add the root to the lerna config (#29154) Dec 6, 2018
npm-shrinkwrap.json Packages: Use a semver ref for babel-plugin-i18n-calypso (#29224) Dec 7, 2018
package.json i18n: Don't translate nested node_modules (#29260) Dec 7, 2018
renovate.json Renovate: bundle WordPress monorepo updates into one PR (#28891) Nov 27, 2018
webpack.config.js Build SDK Gutenpack: Use file-loader to include images (#28378) Nov 9, 2018
webpack.config.node.js Analytics: Add Webpack build timestamp to Tracks page view events (#2… Oct 23, 2018

README.md

Calypso

Renovate enabled

Calypso is the new WordPress.com front-end – a beautiful redesign of the WordPress dashboard using a single-page web application, powered by the WordPress.com REST API. Calypso is built for reading, writing, and managing all of your WordPress sites in one place.

beautiful screenshot

It’s built with JavaScript – a very light node plus express server, React.js, Redux, wpcom.js, and many other wonderful libraries on the front-end.

You can read more about Calypso at developer.wordpress.com/calypso.

Getting Started

You can try out the user-side of Calypso on WordPress.com (a lot of the logged-in area is Calypso; if in doubt, view source), you can poke around the code here on GitHub, or you can install it and run it locally. The latter is the most fun.

  1. Make sure you have git, node, and npm installed.
  2. Clone this repository locally.
  3. Add 127.0.0.1 calypso.localhost to your local hosts file.
  4. Execute npm start from the root directory of the repository.
  5. Open calypso.localhost:3000 in your browser.

Need more detailed installation instructions? We have them.

Contributing

If Calypso sparks your interest, don’t hesitate to send a pull request, send a suggestion, file a bug, or just ask a question. We promise we’ll be nice. Just don’t forget to check out our CONTRIBUTING doc – it includes a few technical details that will make the process a lot smoother.

Calypso welcomes – and indeed has been built by – contributors from all walks of life, with different backgrounds, and with a wide range of experience. We're committed to doing our part to make both Calypso and the wider WordPress community welcoming to everyone.

You can contribute in many ways. You can help reporting, testing, and detailing bugs, and also test new features we release in our "beta" program for testing on Horizon.

To clarify these expectations, Calypso has adopted the code of conduct defined by the Contributor Covenant. It can be read in full here.

Security

Need to report a security vulnerability? Go to https://automattic.com/security/ or directly to our security bug bounty site https://hackerone.com/automattic.

Browser Support

We support the latest two versions of all major browsers, except IE, where we currently only support 11 and Edge. (see Browse Happy for current latest versions).

Troubleshooting

If you have any problems running Calypso, please see most common issues.

License

Calypso is licensed under GNU General Public License v2 (or later).