web.dev is the ultimate resource for developers of all backgrounds to learn, create, and solve on the web. It's meant to not only educate developers, but help them apply what they've learned to any site they work on, be it personal or business.
Note: this repo contains the written content for web.dev. The client-side JS and server are not yet open source.
Our wiki provides docs on authoring guides and codelabs.
git clone --depth 1 https://github.com/GoogleChrome/web.dev.git --recurse-submodules
npm ci
npm run build
Changes to assets will rebuild the site. Refresh to see changes.
npm run dev
Next, open http://localhost:8080/ to see the site locally. The preview server
allows you to see how the content will look on the production site, but it's
not a true staging server. For example, features like search and JS components
may not work or be entirely broken on the local preview.
git submodule update --remote
Stage the site to App Engine.
npm run stage
☝️You'll need to be a member of the App Engine project to run this command.
Preview the site at https://web-dev-staging.appspot.com
The easiest way to debug the site is to add a debugger statement to
.eleventy.js, then run npm run debug, and go to chrome://inspect to
attach to the running process.
You can file an issue in our issue tracker and a team member should reply shortly.
Take a look in the issue tracker for any bugs with a content label.