@celsian/vura-core

Core runtime and build pipeline for Vura — the MIT full-stack meta-framework for apps that outgrow serverless.

What it does

@celsian/vura-core scans src/pages and src/api into a route manifest, drives the build pipeline, and provides the runtime helpers your route handlers import: revalidateTag / revalidatePath (backed by what-isr), signed cookie sessions and JWT auth, typed error helpers, and defineConfig. Pages render through What Framework; API routes run on CelsianJS. You normally get this package via npm create vura@latest — install it directly only when building custom adapters or tooling.

Install

npm install @celsian/vura-core

Minimal example

src/api/posts.ts — revalidate a tag on write:

import type { CelsianRequest, CelsianReply } from '@celsian/vura-core';
import { revalidateTag } from '@celsian/vura-core';

export const route = { compute: { class: 'function', memory: '1gb' } };

export async function POST(req: CelsianRequest, reply: CelsianReply) {
  const body = req.parsedBody as { title: string };
  // ... persist the post
  await revalidateTag('posts');
  return reply.json({ ok: true });
}

vura.config.ts — typed project config:

import { defineConfig } from '@celsian/vura-core';

export default defineConfig({
  api: { defaultKind: 'serverless' },
  pages: { defaultMode: 'static' },
});

Documentation

vura.io docs site launches with v0.5 — until then, see the repo README and CHANGELOG.

• Quick start — /ladder/0-create/
• Config reference — /reference/config/
• API routes — /reference/api-routes/
• Cache revalidation — /reference/cache/
• Auth helpers — /reference/auth/

License

MIT — and it will stay MIT.