Workers foundations

Create the Link Vault project

Scaffold a TypeScript Worker with the current Cloudflare project generator and inspect the generated configuration and scripts.

8 minute lesson

~~~

The course project is Link Vault, a small service that saves useful links, serves a web interface, and exports backups.

Use Cloudflare’s current project generator and select a Worker starter. The generator records current tool versions and a compatibility date, so prefer its output to hand-copying an old configuration example.

npm create cloudflare@latest -- link-vault
cd link-vault
npm run dev

The generated project is also a record of assumptions: package versions, module format, compatibility date, entry point, and local test setup. Commit those files together so another developer can reproduce the same baseline. Do not copy a compatibility date from an old tutorial; it controls runtime behavior and should be advanced intentionally with tests.

Before changing application code, run the generated test and a dry deployment. If either fails, fix the baseline first. Record the local URL, send one request with curl, and inspect the response headers so later routing or binding failures have a known-good comparison.

Open the local URL and identify src/index.ts, wrangler.jsonc, generated types, and test configuration.

Lesson completed

Take this course offline

Get every free book and course as PDF and EPUB files.

Get the download library →