{"id":46322,"library":"seawomp","title":"Seawomp","description":"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.","status":"active","version":"1.2.3","language":"javascript","source_language":"en","source_url":null,"tags":["javascript"],"install":[{"cmd":"npm install seawomp","lang":"bash","label":"npm"},{"cmd":"yarn add seawomp","lang":"bash","label":"yarn"},{"cmd":"pnpm add seawomp","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core rendering and component primitives (html, defineWompo, hydration)","package":"wompo","optional":false},{"reason":"Image optimization at build time (WebP/AVIF variants)","package":"sharp","optional":true}],"imports":[{"note":"PageProps is a TypeScript type-only export; use 'import type' for correct tree-shaking.","wrong":"import { PageProps } from 'seawomp'","symbol":"PageProps","correct":"import type { PageProps } from 'seawomp'"},{"note":"LoaderArgs is also type-only; use 'import type'.","wrong":"import { LoaderArgs } from 'seawomp'","symbol":"LoaderArgs","correct":"import type { LoaderArgs } from 'seawomp'"},{"note":"The defineConfig helper is exported from 'seawomp/config', not the main package.","wrong":"import { defineConfig } from 'seawomp'","symbol":"seawomp config","correct":"import { defineConfig } from 'seawomp/config'"}],"quickstart":{"code":"// Create a new project\n// bunx seawomp new my-app\n// cd my-app\n\n// In app/page.ts (home page)\nimport { html, defineWompo } from 'wompo';\nimport type { PageProps } from 'seawomp';\n\nfunction HomePage({}: PageProps) {\n\treturn html`<h1>Welcome</h1><p>Hello from seawomp!</p>`;\n}\ndefineWompo(HomePage, { name: 'home-page' });\nexport default HomePage;\n\n// Run dev server: bun run dev\n// Build: bun run build\n// Start production: bun run start","lang":"typescript","description":"Creates a minimal seawomp project with a single home page, then runs the development server."},"warnings":[{"fix":"Install Bun 1.1+ from bun.sh; remove Node.js dependencies.","message":"Bun ≥1.1 required — no Node.js support","severity":"breaking","affected_versions":">=0.0"},{"fix":"Pin to exact version (e.g. 1.2.3) and consult changelog before upgrading.","message":"Pre-1.0: API may change without major version bump","severity":"deprecated","affected_versions":"<1.0.0"},{"fix":"Use import type { ... } from 'seawomp'.","message":"TypeScript types (PageProps, LoaderArgs) are type-only — do not import as values","severity":"gotcha","affected_versions":">=0.0"},{"fix":"Import defineConfig from 'seawomp/config'.","message":"defineConfig is exported from 'seawomp/config', not the main package","severity":"gotcha","affected_versions":">=0.0"},{"fix":"Ensure sharp ≥0.33.0 is installed (npm install sharp).","message":"Image optimization requires sharp peer dependency; if missing build may fail","severity":"gotcha","affected_versions":">=0.0"}],"env_vars":null,"search_vec":"'-1.0':25 '1.1':20 '1.2.3':23 'action':49 'api':50 'async':34 'base':30 'build':91 'built':12,55 'built-in':54 'bun':19,69 'bundler':75 'compon':7 'component-first':6 'current':21 'deploy':99 'dev':73,83 'elimin':79 'file':29 'file-bas':28 'first':8,42 'framework':11,63 'hot':87 'hot-reload':86 'hover/visibility':46 'hydrat':43 'imag':57 'island':41 'islands-first':40 'javascript':100 'layout':33 'loader':35 'meta':10 'meta-framework':9 'minifi':94 'nativ':70 'nest':32 'node/vite':66 'offer':27 'optim':58 'output':95 'pipelin':92 'power':17 'pre':24 'prefetch':47 'produc':93 'reload':88 'rout':31,51 'runner':78 'seawomp':1,2 'separ':80 'server':48,74,84 'ssg':52 'ssr':36 'stream':38 'suitabl':96 'support':85 'suspens':39 'test':77 'tie':64 'top':14 'transit':45 'transpil':81 'typescript':72 'unlik':62 'use':68 'variant':61 'vercel':98 'version':22 'view':44 'web':5 'webp/avif':60 'wompo':16","created_at":"2026-06-07T12:59:21.624815+00:00","updated_at":"2026-06-07T12:59:21.624815+00:00","problems":[{"fix":"Run 'bun install seawomp' and ensure import paths are correct (e.g. 'seawomp' for main, 'seawomp/config' for config).","cause":"Package not installed or import path wrong","error":"error: Cannot find module 'seawomp'"},{"fix":"Ensure the page uses 'function Page({ params, data }: PageProps<...>)' and that loader.ts exports 'loader' function.","cause":"Page component missing proper typing or loader not exported","error":"TypeError: Cannot destructure property 'params' of 'undefined'"},{"fix":"Run 'bun add sharp' or 'npm install sharp' and rebuild.","cause":"Missing optional peer dependency","error":"Error: Sharp is not installed. Image optimization requires sharp."}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"seawomp","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}