seawomp

library1.2.3jsnpmunverified

Seawomp is a Web Component-first meta-framework built on top of Wompo, powered by Bun (≥1.1). Current version 1.2.3 (pre-1.0). It offers file-based routing, nested layouts, async loaders, SSR with streaming Suspense, islands-first hydration, View Transitions, hover/visibility prefetch, server actions, API routes, SSG, and built-in image optimization with WebP/AVIF variants. Unlike frameworks tied to Node/Vite, it uses Bun natively for TypeScript, dev server, bundler, and test runner, eliminating separate transpilers. Its dev server supports hot-reload, and the build pipeline produces minified output suitable for Vercel deployment.

devops

npm install seawomp

package ↗

INSTALL

IMPORT

SIG · SEAWOMP

seawomp

devopsjavascriptv1.2.3

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.

PageProps

✓ import type { PageProps } from 'seawomp'

✗ import { PageProps } from 'seawomp'

PageProps is a TypeScript type-only export; use 'import type' for correct tree-shaking.

LoaderArgs

✓ import type { LoaderArgs } from 'seawomp'

✗ import { LoaderArgs } from 'seawomp'

LoaderArgs is also type-only; use 'import type'.

seawomp config

✓ import { defineConfig } from 'seawomp/config'

✗ import { defineConfig } from 'seawomp'

The defineConfig helper is exported from 'seawomp/config', not the main package.

Creates a minimal seawomp project with a single home page, then runs the development server.

// Create a new project // bunx seawomp new my-app // cd my-app // In app/page.ts (home page) import { html, defineWompo } from 'wompo'; import type { PageProps } from 'seawomp'; function HomePage({}: PageProps) { return html`<h1>Welcome</h1><p>Hello from seawomp!</p>`; } defineWompo(HomePage, { name: 'home-page' }); export default HomePage; // Run dev server: bun run dev // Build: bun run build // Start production: bun run start

Debug

Known issues

breakingBun ≥1.1 required — no Node.js support

fix

Install Bun 1.1+ from bun.sh; remove Node.js dependencies.

affects: >=0.0

deprecatedPre-1.0: API may change without major version bump

fix

Pin to exact version (e.g. 1.2.3) and consult changelog before upgrading.

affects: <1.0.0

gotchaTypeScript types (PageProps, LoaderArgs) are type-only — do not import as values

fix

Use import type { ... } from 'seawomp'.

affects: >=0.0

gotchadefineConfig is exported from 'seawomp/config', not the main package

fix

Import defineConfig from 'seawomp/config'.

affects: >=0.0

gotchaImage optimization requires sharp peer dependency; if missing build may fail

fix

Ensure sharp ≥0.33.0 is installed (npm install sharp).

affects: >=0.0

Errors

Common errors & fixes

error: Cannot find module 'seawomp'

Package not installed or import path wrong

fix

Run 'bun install seawomp' and ensure import paths are correct (e.g. 'seawomp' for main, 'seawomp/config' for config).

TypeError: Cannot destructure property 'params' of 'undefined'

Page component missing proper typing or loader not exported

fix

Ensure the page uses 'function Page({ params, data }: PageProps<...>)' and that loader.ts exports 'loader' function.

Error: Sharp is not installed. Image optimization requires sharp.

Missing optional peer dependency

fix

Run 'bun add sharp' or 'npm install sharp' and rebuild.

Upgrade

Version history

1.2.3latest on npm

Audit

Dependencies

womporequiredCore rendering and component primitives (html, defineWompo, hydration)

sharpoptionalImage optimization at build time (WebP/AVIF variants)

Agent activity

8 hits · last 30 days

node

Resources

packageseawomp ↗