@nuasite/components
v0.68.3
Published
Nua Site astro components.
Readme
@nuasite/components
Reusable Astro components optimized for sites connected to Nua Site. The package currently ships:
Form: Progressive enhancement for Nua Site form submissions with friendly UI states.Image: Ergonomic Cloudflare Image Transform helper that builds/cdn-cgi/image/<options>/<src>URLs and responsivesrcset.Video:<video>with the defaults a site video needs, forn.video()field values.
Install
bun add @nuasite/componentsThe package targets Astro projects and expects typescript@^5 to be available
in your workspace (peer dependency).
Usage
Form
---
import { Form } from '@nuasite/components'
---
<Form
action="/contact"
successMessage="Thanks—we'll be in touch!"
submittingMessage="Sending..."
errorMessage="Something went wrong."
/>Pass either a formId issued by Nua Site, or a custom action URL. You
can override the default success, error, submitting, and retry copy via props.
Responsive image (Cloudflare)
---
import { Image } from '@nuasite/components'
---
<Image
src="https://cdn.nuasite.com/assets/www-mangoweb-cz/vakovako-3.webp"
alt="Abstract architectural pattern with curved windows."
widths={[480, 768, 1024, 1400, 1920]}
sizes="(min-width: 1024px) 60vw, 100vw"
transformOptions={{ fit: 'cover', dpr: 1.5 }}
/>Key props:
widths: Breakpoints used to buildsrcset(defaults provided).sizes:sizesattribute string; controls browser selection.transformOptions: Cloudflare transform params (quality, fit, dpr, format, etc.).deliveryBase: Override/cdn-cgi/imageif you proxy through another path or domain.allowedDomains: Whitelist of hostnames that should be transformed. Leave empty to allow all; when set, non-matching hosts fall back to the originalsrcwith no transform.
Absolute src values keep their origin and prepend the transform path, e.g.
https://cdn.nuasite.com/cdn-cgi/image/.../assets/file.webp.
Video
---
import { Video } from '@nuasite/components'
---
<Video src={entry.data.animation} autoplay loop class="w-full" />src is used verbatim, so an n.video() value works whether it is a repository path or a CDN URL.
An autoplay video is always muted and playsinline, because browsers block autoplay with sound
and iOS plays inline only when asked. preload defaults to auto for autoplay and metadata
otherwise. Every other <video> attribute (controls, loop, poster, width, …) passes through.
Types
TypeScript projects can import the component props to help with strongly typed helper utilities:
import type { FormProps } from '@nuasite/components'
const defaults: FormProps = {
formId: 'contact',
successMessage: 'Success!',
}FormProps ensures at least one of formId or action is provided at compile
time, catching configuration mistakes early.
Local development
If you need to work on the components themselves:
cd packages/components
bun install
bunx tsx src/index.tsDuring local testing you can import components directly via workspace links in your Astro project to iterate quickly.
