Haystack

Haystack is a bookmark knowledge base and AI chat app built with Vite, Nitro v3 (h3 v2), TanStack Router, React, Tailwind CSS v4, Better Auth, Prisma, Pinecone, and Trigger.dev.

Getting started

Install dependencies with Bun:

bun install

Copy .env.example to .env and provide:

DATABASE_URL=BETTER_AUTH_SECRET=BETTER_AUTH_URL=http://rig:3003GROQ_API_KEY=PINECONE_API_KEY=FIRECRAWL_API_KEY=TRIGGER_SECRET_KEY=

Generate the Prisma client and start the app:

bun run db:generate
bun run dev

The development server runs at http://rig:3003.

Scripts

• bun run dev — run the Vite/Nitro development server on port 3003
• bun run build — create the production build
• bun run preview — preview the production build
• bun run typecheck — run TypeScript without emitting files
• bun run db:generate — generate the Prisma client
• bun run db:migrate — create and apply development migrations
• bun run db:deploy — apply production migrations
• bun run auth:generate — update the Better Auth Prisma schema
• bun run trigger:dev — run Trigger.dev locally
• bun run ui:add @iconiq/b-button — add an editable Iconiq UI component from the registry

UI components

Iconiq UI is configured as a shadcn-compatible registry in components.json. Use the namespaced component address when adding components:

bun run ui:add @iconiq/b-button

The generated files are copied into src/components/ui so they remain editable in this project. The registry is available at https://iconiqui.com/r/{name}.json.