Paths are under apps/cosmos/digital-services/ unless noted.
| File | Scope | Effect if changed |
|---|
astro.config.mjs | App | Site URL, integrations (React, Tailwind, sitemap), image service, Vite aliases, build output layout. |
package.json | App | Canonical commands: dev, build, lint, Jest, Playwright, worker build/deploy. Wrangler [build] command in TOML still references npm run build—from the monorepo, prefer yarn workspace cosmos-digital-services build. |
tailwind.config.js | App | Utility classes and design tokens pipeline into global.css / generated CSS. |
playwright.config.ts | Tests | E2E base URL, webServer hook, projects, timeouts. |
jest.config.cjs | Tests | Unit test environment, transforms, module maps. |
babel.config.json | Tests/build | Jest/Babel TS handling for tests. |
.eslintrc.cjs | Quality | Lint rules for .js, .ts, .astro. |
| File | Scope | Effect if changed |
|---|
public/_headers | Deployed static layer | CSP, cache-control, /api/* CORS, security headers. Changes apply without any .astro edit—treat as production-critical. |
public/_redirects | Static | Redirect rules for the static host/worker site. |
| File | Scope | Effect if changed |
|---|
workers/wrangler.gateway.toml | Gateway | Routes for /api/*, /portal*, /admin*; AUTH_WORKER_VERIFY_URL and PROTECTED_PATH_PREFIXES per environment; site bucket path; build command. Wrong routes → session returns HTML, auth bypass, or broken portal. |
workers/wrangler.image.toml | Image worker | Image route patterns per host/env; ENABLE_IMAGE_RESIZING. Missing extension → optimizer never runs. |
Any change to _headers, worker routes, or Wrangler vars can alter production behavior without an Astro component diff. Pair those changes with deploy verification (see Deployment guide and Troubleshooting).