JavaScript CSS Other
Latest commit 9173387 Feb 22, 2017 @markryall markryall committed on GitHub Free to paid upsell nudges (#11380)
* Placeholder notice (without logic) for free to paid plan upsell.

* Add free to paid plan (with no logic yet) nudge placeholder to stats page.

* Use abtest variations to determine whether to show sidebar or stats free to paid nudge.

* Allow existing users to participate in ab test.

* Introduce abtest selector for free to paid upsell eligibility.

* Move eligibleForFreeToPaidUpsell to state/selectors.

* Check eligibility for free to paid upsell before evaluating abtest.

* Eliminate paid plans from free to paid upsell abtest.

* Ensure user can manage options for site for eligibility for free plan upsell.

* Extract isSiteOnFreePlan to a new selector.

* Add selector to determine whether user has been registered within a specified range of days.

* Include user registration days criteria in determining eligibility for free to paid upsell.

* Correct boolean logic for determining whether to show nudges.

* Add selector for whether a site has a mapped domain.

* Exlude sites with mapped domain from free to paid upsell abtest.

* Pass moment as parameter to selectors so they can remain pure functions.

* Remove FreeToPaidNudge from StatsNavigation.

* Move FreeToPaid nudge to client/blocks.

* Rename FreeToPaidNudge to FreeToPaidBanner.

* Add FreeToPaidBanner to stats site page.

* Change icon for free to paid banner from personal plan to star.

* Change free to paid upsell experiment variant distribution to 45/45/10.

* Change copy in free to paid banner.

* Change copy on sidebar nudge for free to paid upsell.

* Updated copy for banner variant of abtest.

* Determine currently selected site from state rather than props.

* Only show banner on stats page for days.

* Use camel case key name instead of snake case for plan product slug.

* Ensure documentation is present and consistently formatted for new selectors.

* Use localize to translate FreeToPaidBanner.

* Remove banner variant from free to paid upsell.

* Update test date to flush out spurious variants from test data.

* Remove redundant external references section.

* Change bool to ?Boolean in selector documentation.
Failed to load latest commit information.
.github Docs: fix Sass spelling (#10781) Jan 19, 2017
assets/stylesheets Settings: Add comments label & color scheme settings to discussion tab ( Feb 21, 2017
bin Framework: Remove CSS modules Feb 6, 2017
client Free to paid upsell nudges (#11380) Feb 22, 2017
config Republicize:Release (#11497) Feb 21, 2017
docs Documentation: Hello World consistency & clarity Feb 6, 2017
public Happychat: Add notification sound for new messages (#10724) Feb 13, 2017
server Build: Minify bundles in parallel (#11385) Feb 15, 2017
test Testing: Warn against likely erroneous test path (#10478) Feb 2, 2017
.babelrc State: Support exporting selectors from state/selectors Dec 21, 2016
.dockerignore ignore .vscode in all-the-things (as requested in #9029) (#9167) Nov 6, 2016
.editorconfig Initial commit of wp-calypso Nov 20, 2015
.esformatter Initial commit of wp-calypso Nov 20, 2015
.eslintignore ignore .vscode in all-the-things (as requested in #9029) (#9167) Nov 6, 2016
.eslintrc.js ESLint: Add rules for restricting usage of sites-list and data-observe ( Nov 18, 2016
.gitattributes Phone-Input: Add flag-icon-css Nov 10, 2016
.gitignore DevDocs: Generate an index of proptypes for client consumption (#9919) Dec 22, 2016
.jsfmtrc Initial commit of wp-calypso Nov 20, 2015
.npmrc Initial commit of wp-calypso Nov 20, 2015
.nvmrc Build: update to Node 6.9.4 (#10541) Jan 11, 2017
.rtlcssrc i18n: Update RTLCSS to 2.0.5 (#5440) May 26, 2016
.stylelintrc Introducing stylelint to lint and alert css styling errors (#6356) Jul 6, 2016 Code of Conduct: link to a contact form instead of using an email. Jan 22, 2016 Updated repo urls for redux & react-redux Dec 18, 2016
Dockerfile Build: update to Node 6.9.4 (#10541) Jan 11, 2017 Initial commit of wp-calypso Nov 20, 2015
Makefile Makefile: add a few useful docker commands to the makefile (#11303) Feb 11, 2017 Update documentation around alternate installation option Jan 25, 2017
Vagrantfile Initial commit of wp-calypso Nov 20, 2015
Vagrantfile-boot2docker Initial commit of wp-calypso Nov 20, 2015
circle.yml Build: update to Node 6.9.4 (#10541) Jan 11, 2017
index.js Framework: Upgrade ESLint no-console to error Nov 1, 2016
jsconfig.json Initial commit of wp-calypso Nov 20, 2015
npm-shrinkwrap.json Upgrade to v2.2.5 of twemoji (#11420) Feb 21, 2017
package.json Upgrade to v2.2.5 of twemoji (#11420) Feb 21, 2017
webpack-dll.config.js Build: Move react-dom and redux-thunk into vendor, drop debug (#9146) Nov 7, 2016
webpack.config.js Framework: Remove CSS modules Feb 6, 2017
webpack.config.node.js Framework: Remove CSS modules Feb 6, 2017


Calypso is the new front-end – a beautiful redesign of the WordPress dashboard using a single-page web application, powered by the 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

Getting Started

You can try out the user-side of Calypso on (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 calypso.localhost to your local hosts file.
  4. Execute make run or make dashboard (for a more visually-oriented interface) from the root directory of the repository.
  5. Open calypso.localhost:3000 in your browser.

Need more detailed installation instructions? We have them.


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.


Need to report a security vulnerability? Go to or directly to our security bug bounty site

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).


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


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