The JavaScript and API powered WordPress.com
Switch branches/tags
Clone or download
alisterscott Merge pull request #27413 from touletan/fix/devdocs-start-page-redire…
…ct-when-lgin-from-masterbar

redirect from devdocs/start to devdocs/welcome when user is loggedIn
Latest commit 047412b Sep 25, 2018
Permalink
Failed to load latest commit information.
.circleci CI: Overhaul for speed 🚀 (#27180) Sep 25, 2018
.github DevDocs: add doc for creating new components (#24172) Apr 18, 2018
assets/stylesheets Build CSS assets with Webpack (#26820) Sep 21, 2018
bin CI: Overhaul for speed 🚀 (#27180) Sep 25, 2018
client Merge pull request #27413 from touletan/fix/devdocs-start-page-redire… Sep 26, 2018
config Activity Log: Enable filterbar in production. (#27383) Sep 25, 2018
docs SDK: rename block entry-files (#27119) Sep 18, 2018
packages SDK: Add new `packages` top-level directory (#27026) Sep 7, 2018
public Publicize: remove support for Path (#27291) Sep 21, 2018
server Build CSS assets with Webpack (#26820) Sep 21, 2018
test CI: Overhaul for speed 🚀 (#27180) Sep 25, 2018
.dockerignore Build: Remove tests from Docker build context (#22220) Feb 16, 2018
.editorconfig Framework: Switch to 4 space tabs for GitHub diffs Jun 7, 2017
.eslines.json Never ignore undef errors. (#26528) Aug 7, 2018
.eslintignore Build: Anchor eslintignore dirs to project root (#26230) Aug 3, 2018
.eslintrc.js Lint: Specify the react version (#26960) Aug 30, 2018
.gitattributes Framework: Handle npm-shrinkwrap merge conflicts with merge driver (#… Jun 20, 2018
.gitignore Git-ignore all CSS files in /public Aug 24, 2018
.npmrc Update to Node 10 (10.4.0) and npm 6.1.0 (#25374) Jun 11, 2018
.nvmrc Update Node.js to v10.10.0 (#27057) Sep 12, 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 Update Node.js to v10.10.0 (#27057) Sep 12, 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 Update babel monorepo to v7.0.0 (#26497) Aug 29, 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: Replace `config('env')` with `process.env.NODE_ENV (#20935) Dec 28, 2017
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
npm-shrinkwrap.json Update dependency react-transition-group to v2 (#27353) Sep 24, 2018
package.json CI: Overhaul for speed 🚀 (#27180) Sep 25, 2018
renovate.json Renovate: Include @babel/* in updates (#26439) Aug 1, 2018
webpack.config.js SDK: Use newly-merged notifications panel code in Calypso (#26760) Sep 6, 2018
webpack.config.node.js Add support for building CSS in Webpack (#26864) Aug 24, 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).