This page is served from the '${path.basename(rootDir)}' directory.
\\nServer running on port ${port}.
\\n\\n`);\n}\n\nasync function startServer() {\n try {\n const serverOptions = {\n port: port,\n root: rootDir,\n index: indexFile,\n log: true\n };\n\n const server = await createServez(serverOptions);\n console.log(`Servez server started successfully.`);\n console.log(`Serving files from: ${server.root}`);\n console.log(`Access at: http://localhost:${server.port}`);\n\n process.on('SIGINT', async () => {\n console.log('\\nShutting down Servez server...');\n await server.kill();\n console.log('Servez server shut down.');\n process.exit(0);\n });\n\n } catch (error) {\n console.error('Failed to start Servez server:', error);\n process.exit(1);\n }\n}\n\nstartServer();","lang":"javascript","description":"This example demonstrates how to initialize and start a basic HTTP server using `servez-lib` to serve static files from a 'public' directory, handling graceful shutdown."},"warnings":[{"fix":"Fork or copy the relevant source code files from `servez-lib` into your project, or choose a different, externally-maintained HTTP server library designed for public consumption and extension.","message":"The author explicitly states this library is not intended for external use or extension by third parties; instead, it's recommended to copy the source code directly into your project. Treating it as a general-purpose library will likely lead to unexpected breaking changes, lack of support, or unaddressed issues.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Do not rely on `servez-lib` for long-term external API stability. Any version update should be treated as potentially introducing breaking changes for third-party usage.","message":"API stability is not guaranteed for external consumers. Changes may be introduced without strict adherence to semantic versioning principles for third-party integrations, as the library primarily serves internal projects by the same author.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Prefer CommonJS `require()` for maximum compatibility. If using ESM, use `import createServez from 'servez-lib';` and thoroughly test your application, especially for advanced features.","message":"The library is primarily designed for CommonJS (CJS) environments. While it can be imported in ESM projects using default import syntax, direct named ESM imports or explicit `package.json` `type: \"module\"` configurations might not be fully supported or tested for all functionalities.","severity":"gotcha","affected_versions":"*"}],"env_vars":null,"last_verified":"2026-04-23T00:00:00.000Z","next_check":"2026-07-22T00:00:00.000Z","problems":[{"fix":"Change the `port` option in your `createServez` configuration to an unused port (e.g., 3000, 8000), or identify and terminate the conflicting process.","cause":"Another process on your machine is already using the specified port (e.g., 8080).","error":"Error: listen EADDRINUSE: address already in use :::8080"},{"fix":"Ensure the directory specified by the `root` option exists. Create it if necessary before starting the server, or correct the path if it's misspelled.","cause":"The `root` directory specified in the server options does not exist on your file system.","error":"Error: ENOENT: no such file or directory, stat '/path/to/nonexistent/root'"},{"fix":"Set the `index` option in `createServez` to the name of your desired index file (e.g., `index: 'index.html'`) and verify that this file exists directly within the `root` directory you are serving.","cause":"The `index` option might not be correctly configured, or the specified index file (e.g., `index.html`) is not present in the `root` directory.","error":"When accessing the server, I see a directory listing instead of my index.html page."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}