Aska

An open-source, conversational form engine built on a modern, type-safe stack.

Tech Stack

• Framework: React 19 + TanStack Start (SSR, isomorphic loaders)
• API: tRPC
• Auth: Better Auth
• Database: PostgreSQL + Prisma ORM
• Styling: Tailwind CSS v4
• Storage: AWS S3 or Cloudflare R2 (for file and media attachments)
• Package Manager: Bun

Features

• Conversational Layout: Question-by-question presentation designed for completion rates.
• Visual Canvas Builder: Side-by-side editing canvas showing form updates in real-time.
• 15+ Field Types: Standard inputs, NPS®, opinion scales, star ratings, signatures, and media uploads.
• Automatic Scheduling: Start and end dates with custom timezone support and automated countdowns.
• Themes & Fonts: 10+ visual themes (Forest, Peach, Cyberpunk, etc.) and typography pairings.
• Submissions Dashboard: Response inspector with native players for audio/video uploads and signature viewing.

Development Setup

Prerequisites

• Bun installed locally.
• PostgreSQL running database.
• Cloudflare R2 or AWS S3 bucket for uploads.

Setup Steps

1. Install Dependencies:

   bun install

2. Configure Environment: Copy the example environment file and fill in your keys:

   cp .env.example .env

3. Database Setup: Run Prisma migrations to create the schemas:

   bun run db:push

   Or to run migrations:

   bun run db:migrate

4. Start Development Server:

   bun run dev

   Open http://localhost:3000 in your browser.

Database Management

• Open Prisma Studio to inspect local database records:

  bun run db:studio

• Generate the Prisma client after schema edits:

  bun run db:generate