Calypso

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.

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.

Make sure you have git, node, and npm installed.
Clone this repository locally.
Add 127.0.0.1 calypso.localhost to your local hosts file.
Run npm install
Execute make run or make dashboard (for a more visually-oriented interface) from the root directory of the repository.
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).

Failed to load latest commit information.
.github	Docs: add missing npm install step (#11773 )	May 6, 2017
assets/stylesheets	Add Form and suporting logic for .FR domains extra registrant details	Jun 1, 2017
bin	Scripts: Move all non executable codemod files to src folder	May 29, 2017
client	Merge pull request #13159 from Automattic/update/edit-gravatar-button…	Jun 1, 2017
config	Add Form and suporting logic for .FR domains extra registrant details	Jun 1, 2017
docs	Framework: rename combineReducersWithPersistence to combineReducers	May 24, 2017
integration/bin/test	Build: add integration test for get-circle-string-artifact-url (#13624 )	May 16, 2017
public	Illustration: move no sites image (#14608 )	May 31, 2017
server	Merge pull request #13350 from Automattic/update/404-500-illustrations	May 30, 2017
test	Build: add integration test for get-circle-string-artifact-url (#13624 )	May 16, 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
.eslines.json	Set ESLint rules as errors while preventing build tools from failing. (…	Mar 22, 2017
.eslintignore	Don't ignore this one bin file	Apr 19, 2017
.eslintrc.js	Framework: set wpcalypso/import-no-redux-combine-reducers to error an…	May 25, 2017
.gitattributes	Phone-Input: Add flag-icon-css	Nov 10, 2016
.gitignore	Framework: Hide analyze-bundles changed behind process env constant	Apr 19, 2017
.jsfmtrc	Initial commit of wp-calypso	Nov 20, 2015
.npmrc	Initial commit of wp-calypso	Nov 20, 2015
.nvmrc	Build: update to node 6.10.3 (#13739 )	May 9, 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.md	Code of Conduct: link to a contact form instead of using an email.	Jan 22, 2016
CREDITS.md	Updated repo urls for redux & react-redux	Dec 18, 2016
Dockerfile	Changed Dockerfile to use "npm run build" instead of "make build" (#1…	May 31, 2017
LICENSE.md	Initial commit of wp-calypso	Nov 20, 2015
Makefile	Feature: Allow devs to pass arguments to the node command via env var…	May 12, 2017
README.md	Docs: add missing npm install step (#11773 )	May 6, 2017
Vagrantfile	Initial commit of wp-calypso	Nov 20, 2015
Vagrantfile-boot2docker	Initial commit of wp-calypso	Nov 20, 2015
circle.yml	Make the build / run / test process Windows-compatible by adding NPM …	May 24, 2017
index.js	Changed Dockerfile to use "npm run build" instead of "make build" (#1…	May 31, 2017
jsconfig.json	jsconfig: updates the target compiler option to ES6 (#14492 )	May 29, 2017
npm-shrinkwrap.json	Notifications: Use `notifications-panel` v1.1.14. (#14691 )	Jun 1, 2017
package.json	Notifications: Use `notifications-panel` v1.1.14. (#14691 )	Jun 1, 2017
webpack.config.js	Make the build / run / test process Windows-compatible by adding NPM …	May 24, 2017
webpack.config.node.js	Make the build / run / test process Windows-compatible by adding NPM …	May 24, 2017

Automattic/wp-calypso

Clone with HTTPS

README.md