Our documentation is open source so that we can stay connected with our community and quickly implement feedback. Whether you have opened an issue to provide feedback or contributed your own content, we thank you for helping us maintain quality documentation.
If you have any feedback for our documentation or are interested in contributing, please refer to our contribution guidelines.
You must have a recent version of Node.js (22+) installed. You may use Volta, a Node version manager, to install the latest version of Node and npm
, which is a package manager that is included with node
's installation.
$ curl https://get.volta.sh | bash
$ volta install node
Install the Node.js dependencies for this project using npm or another package manager:
$ npm install
When making changes to the site, including any content changes, you may run a local development server by running the following command:
$ npm run dev
This spawns a server that will be accessible via http://localhost:1111
in your browser. Additionally, any changes made within the project – including content/**
changes – will automatically reload your browser tab(s), allowing you to instantly preview your changes.
Part of our application accesses the GitHub API (to populate the Wrangler changelog).
Since GitHub gives a higher request limit to authenticated requests, you may want to add a classic token with permissions for repos:public_repo
to /assets/secrets/github_token.txt
. The token value should be the only thing in your file.
Our docs are deployed using Cloudflare Pages. Every commit pushed to production will automatically deploy to developers.cloudflare.com, and any pull requests opened will have a corresponding staging URL available in the pull request comments.
To get write access to this repo, please reach out to the Developer Docs room in chat.
Except as otherwise noted, Cloudflare and any contributors grant you a license to the Cloudflare Developer Documentation and other content in this repository under the Creative Commons Attribution 4.0 International Public License, see the LICENSE file, and grant you a license to any code in the repository under the MIT License, see the LICENSE-CODE file.
Cloudflare products and services referenced in the documentation may be either trademarks or registered trademarks of Cloudflare in the United States and/or other countries. The licenses for this project do not grant you rights to use any Cloudflare names, logos, or trademarks. Cloudflare's general trademark guidelines can be found at https://www.cloudflare.com/trademark/. Cloudflare and any contributors reserve all other rights, whether under their respective copyrights, patents, or trademarks, whether by implication, estoppel, or otherwise.
Please note that we may use AI tools to help us review technical documentation, pull requests and other issues submitted to our public GitHub page in order to identify and correct mistakes and other inconsistencies in our developer documentation. Please refrain from sharing any personal information in your submissions.
All commands are run from the root of the project, from a terminal:
Command | Action |
---|---|
npm install |
Installs dependencies |
npm run dev |
Starts local dev server at localhost:4321 |
npx astro build |
Build your production site to ./dist/ |
npm run astro -- --help |
Get help using the Astro CLI |
Check out Starlight’s docs, read the Astro documentation, or jump into the Astro Discord server.