This is a static file.
');\n await fs.writeFile(path.join(publicDir, 'styles.css'), 'body { font-family: sans-serif; background-color: #f0f0f0; }');\n}\n\n// Initialize sirv handler\nconst assets = sirv(publicDir, {\n maxAge: 31536000, // 1 year\n immutable: true,\n gzip: true, // Look for precompiled .gz files\n dotfiles: false, // Don't serve dotfiles\n dev: process.env.NODE_ENV === 'development' // Enable dev mode for caching control\n});\n\nconst PORT = process.env.PORT ?? 3000;\n\nawait setupPublicDir();\n\npolka()\n .use(compression()) // Apply compression before sirv\n .use(assets) // Serve static assets\n .use('/api', (req, res) => {\n res.setHeader('Content-Type', 'application/json');\n res.end(JSON.stringify({ message: 'This is an API endpoint', timestamp: Date.now() }));\n })\n .listen(PORT, (err) => {\n if (err) throw err;\n console.log(`> Ready on http://localhost:${PORT}!`);\n console.log(`> Serving static files from ${publicDir}`);\n });","lang":"typescript","description":"This quickstart demonstrates how to set up `sirv` with `polka` and `compression` to serve static files from a 'public' directory. It highlights ESM usage, configuration options like `maxAge` and `dev` mode, and shows how to integrate it alongside other middleware. It dynamically creates a 'public' directory and files for immediate execution."},"warnings":[{"fix":"Upgrade Node.js to version 18 or higher (e.g., using nvm) or pin sirv to a 2.x version in your `package.json` (e.g., `\"sirv\": \"^2.0.0\"`).","message":"Sirv v3.0.0 and later require Node.js version 18 or higher. Projects running on older Node.js versions must either upgrade Node.js or remain on sirv v2.x.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Migrate your imports to use ESM syntax: `import sirv from 'sirv';`. Ensure your project is configured for ESM, typically by setting `\"type\": \"module\"` in `package.json` or using `.mjs` file extensions.","message":"Sirv v3.0.0 introduced native ESM support via an `exports` map, which changes how the package is imported. Direct `require()` statements in ESM contexts or projects with `\"type\": \"module\"` in `package.json` may break, resulting in `ERR_REQUIRE_ESM`.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Ensure `opts.dev` is set to `false` or omitted (default is `false`) for production builds. A common pattern is `dev: process.env.NODE_ENV === 'development'`.","message":"Using `opts.dev: true` enables 'dev' mode, which disables file caching and performs file system checks on every request. This is highly inefficient and should *never* be used in production environments, as it will severely degrade performance.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Always provide an absolute path for `dir`, e.g., using `path.resolve(__dirname, 'public')` or `path.join(path.dirname(fileURLToPath(import.meta.url)), 'public')` for ESM.","message":"The `dir` option in `sirv(dir, opts)` expects a directory path. While it resolves relative paths based on `process.cwd()`, relying on `process.cwd()` can be brittle in complex deployment scenarios. Incorrect paths can lead to assets not being found.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Ensure your file structure does not have top-level files named identically to your static asset directory (e.g., if `dir` is 'public', do not have a file named 'public' in the root serving directory).","message":"Sirv v3.0.2 includes a patch to prevent serving top-level files that unexpectedly share a name with the configured static directory. If you previously relied on such a pattern for some edge cases, this behavior will now be prevented.","severity":"gotcha","affected_versions":">=3.0.2"}],"env_vars":null,"last_verified":"2026-04-22T00:00:00.000Z","next_check":"2026-07-21T00:00:00.000Z","problems":[{"fix":"Change `const sirv = require('sirv');` to `import sirv from 'sirv';` and ensure your project uses ES Modules correctly.","cause":"Attempting to `require('sirv')` in a Node.js environment configured for ES Modules (`\"type\": \"module\"` in `package.json`) after upgrading to sirv v3+.","error":"ERR_REQUIRE_ESM: require() of ES Module ... sirv/index.mjs not supported."},{"fix":"Verify the `dir` path is absolute and correct. Check if `opts.dotfiles` is `true` for dotfiles, and `opts.extensions` includes the necessary fallback extensions (e.g., `['html']` for `/foo` to find `/foo.html`). Also, ensure file permissions allow Node.js to read the files.","cause":"The `dir` option provided to `sirv()` is incorrect, or the requested file does not exist within that directory, or `opts.dotfiles` and `opts.extensions` are not configured to match the asset.","error":"GET /path/to/asset 404 Not Found"},{"fix":"Change the `PORT` variable in your quickstart code to an unused port (e.g., 8080, 5000) or ensure the conflicting process is stopped. You can also use a tool like `lsof -i :