FormTransform

A SvelteKit static site for converting XLSForm questionnaires to the LimeSurvey TSV format.

Prerequisites

• Bun (package manager and runtime)
• Node.js >= 20

Setup

# Install dependencies
bun install

# Copy the example env file and fill in values as needed
cp .env.example .env

Environment variables

Variable	Required	Description
GITHUB_TOKEN	No	GitHub personal access token. Avoids API rate limits (60 req/hour unauthenticated) when fetching content snippets during build.

Developing

bun run dev

# or start the server and open the app in a new browser tab
bun run dev -- --open

Building

bun run build

Preview the production build locally:

bun run preview

Deployment

The app is deployed via Coolify using nixpacks. The nixpacks.toml pins the bun version used in the build container.