server-kit

library0.11.7jsnpmunverified

Server Kit is a minimalistic HTTP and WebSocket server and router for Node.js, currently in early alpha (v0.11.7). It provides a lightweight alternative to Express or Koa with built-in WebSocket support. Designed for simplicity and low overhead, it uses a straightforward API for routing and middleware. Suitable for small to medium projects where minimal dependencies are desired. Note: alpha stage means frequent breaking changes.

devops

npm install server-kit

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SERVER-KIT

server-kit

devopsjavascriptv0.11.7

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Server

✓ import { Server } from 'server-kit'

✗ const server = require('server-kit')

ESM only; CJS require() will not work.

Router

✓ import { Router } from 'server-kit'

✗ import router from 'server-kit'

Named export, not default.

WebSocket

✓ import { WebSocket } from 'server-kit'

✗ import WebSocket from 'server-kit'

Named export; used for WebSocket handling.

Shows basic HTTP GET route and WebSocket echo endpoint using Server Kit's ESM API.

import { Server } from 'server-kit'; const server = new Server(); server.get('/', (req, res) => { res.end('Hello World'); }); server.ws('/echo', (ws, req) => { ws.on('message', (msg) => ws.send(msg)); }); server.listen(3000, () => { console.log('Server running on port 3000'); });

Debug

Known issues

breakingv0.10.0 reworked routing API; old path parameter syntax no longer supported.

fix

Update route definitions to use new parameter syntax (e.g., '/users/:id' instead of '/users/{id}').

affects: >=0.10.0

gotchaVersion 0.11.x dropped support for Node.js 14; requires Node >= 16.13.0.

fix

Upgrade Node.js to version 16.13.0 or higher.

affects: >=0.11.0

deprecatedDefault export removed in v0.9.0; use named exports only.

fix

Replace `import serverKit from 'server-kit'` with `import { Server, Router } from 'server-kit'`.

affects: >=0.9.0

gotchaWebSocket support requires the 'ws' package to be installed as a peer dependency? Check documentation.

fix

If WebSocket errors occur, ensure `ws` is installed via `npm install ws`.

affects: >=0.11.0

Errors

Common errors & fixes

TypeError: serverKit is not a function

Attempting to use default import that doesn't exist in recent versions.

fix

Use named imports: `import { Server } from 'server-kit'`.

Error: Cannot find module 'ws'

Missing peer dependency 'ws' for WebSocket functionality.

fix

Install ws: `npm install ws`.

SyntaxError: Unexpected token '?'

Node.js version too old for optional chaining used by server-kit >=0.10.0.

fix

Upgrade Node.js to v16.13.0 or later.

Upgrade

Version history

0.11.7latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

6 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/cronvel/server-kit ↗

packageserver-kit ↗

homepagehttps://github.com/cronvel/server-kit#readme ↗