The JavaScript and API powered WordPress.com
Clone or download
michaeldcain SiteMockup: update default styles to more closely match theme (#30249)
* First pass at desktop styles.

* More styling.

* One last line-height.
Latest commit 3cd9806 Jan 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Extract code to build custom properties defs to script and use in pre… Jan 17, 2019
.github remove 'beta' note from pr template (#27520) Oct 2, 2018
assets/stylesheets Colour Scheming: Update External Brand Variables (#30084) Jan 18, 2019
bin Extract code to build custom properties defs to script and use in pre… Jan 17, 2019
client SiteMockup: update default styles to more closely match theme (#30249) Jan 18, 2019
config Push Notification: Add VAPID support via applicationServerKey (#30110) Jan 16, 2019
docs Docs: add section about dynamic reducers to our data persistence docs ( Jan 18, 2019
packages Update mobile phone validation module (used for 2fa) (#29740) Jan 3, 2019
public Update the Mastercard Logo (#30138) Jan 14, 2019
server Reformat JS files with Prettier 1.15.3 Jan 9, 2019
test Merge pull request #29073 from Automattic/add/eslint-packages Dec 19, 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: Use Gutenberg svg wrappers for extensions (#29531) Dec 18, 2018
.gitattributes GitHub: Use JSX syntax highlighting for *.js (#28459) Nov 12, 2018
.gitignore Fix the clean:public script to do a better job cleaning public/ folder ( Dec 17, 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
.prettierrc remove pragma options from .prettierrc (#29403) Dec 14, 2018
.rtlcssrc i18n: Update RTLCSS to 2.0.5 (#5440) May 26, 2016
.stylelintrc Turn off prettier for SASS, use stylelint instead (#29697) Jan 2, 2019
CODE-OF-CONDUCT.md update link Sep 11, 2017
CREDITS.md Refactor: Replace use of key-mirror with inline code (#29857) Jan 2, 2019
Dockerfile Build: Allow build concurrency to be limited (#30097) Jan 11, 2019
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 Move overrides to main babel config Dec 20, 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 Reformat JS files with Prettier (#29931) Jan 7, 2019
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 Prepare i18n package for Calypso repo Dec 11, 2018
npm-shrinkwrap.json Upgrade webpack-rtl-plugin to 1.8.0 which upgrades cssnano from v3 to… Jan 18, 2019
package.json Upgrade webpack-rtl-plugin to 1.8.0 which upgrades cssnano from v3 to… Jan 18, 2019
postcss.config.js chore(styles): update css pipeline to emit fallback colors for IE11 (#… Jan 15, 2019
renovate.json chore(deps): Update renovate config to use semantic commits (#30126) Jan 17, 2019
webpack.common.js Build: Allow build concurrency to be limited (#30097) Jan 11, 2019
webpack.config.js Upgrade webpack-rtl-plugin to 1.8.0 which upgrades cssnano from v3 to… Jan 18, 2019
webpack.config.node.js Build: Allow build concurrency to be limited (#30097) Jan 11, 2019

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