Templates & Agent Skills

Bunderstack ships with a production-ready SaaS template and a suite of AI coding agent skills to streamline building full-stack applications with TanStack Start, TanStack Router, and TanStack Query.

BunderSaaS Template (templates/tanstack-start-saas)

The BunderSaaS template is a complete, full-stack SaaS workspace built on Bunderstack and TanStack Start.

Key Features

• Dual Dashboards & Auth Contexts:
  • Client Workspace (/app/*): Guarded by clientAuth route context in src/routes/app/layout.tsx using requireClientAuth.
  • Admin Portal (/admin/*): Guarded by adminAuth route context in src/routes/admin/layout.tsx using requireAdminAuth (role === 'admin').
• Isomorphic Session Validation: Root beforeLoad in src/routes/__root.tsx fetches the session user isomorphically via fetchUser().
• shadcn/ui Ready: Pre-configured components.json, Tailwind v4, Lucide icons, Radix primitives, and @shadcnstore registry support (bunx shadcn@latest add <component>).
• Real-Time Delivery Rail: Visual project status and proof attachment upload pipeline.
• Background Worker & Cron: Wired worker.ts process for background jobs and scheduled sweeps.

Quick Start with BunderSaaS

cd templates/tanstack-start-saas
bun install
cp .env.example .env
bun run db:generate
bun run dev

In a separate terminal, run the background queue worker:

bun run worker

Bunderstack Agent Skills

Two skills ship with the bunderstack package, so the guidance an agent reads always matches the version you installed.

Install them

bunx bunderstack skills

That copies both skills into .agents/skills/ and adds a Bunderstack block to AGENTS.md. The pointer matters as much as the files: agents read AGENTS.md before they search for anything, so it is what actually pulls the skills into context when the model works in your repository.

Re-run the command after upgrading Bunderstack to pick up the current guidance. It replaces its own block and leaves the rest of AGENTS.md alone.

Keep them honest in CI:

bunx bunderstack skills --check

That exits non-zero when the installed skills drift from the package or the AGENTS.md block is missing. Use --dir to install somewhere other than .agents/skills.

The package ships two agent-readable references. llms.txt is the compact working contract at node_modules/bunderstack/llms.txt and /llms.txt. llms-full.txt contains the complete documentation corpus at node_modules/bunderstack/llms-full.txt and /llms-full.txt. Start compact and load the full corpus when a task crosses several framework capabilities.

TanStack Agent Skills

Bunderstack integrates TanStack Agent Skills to guide AI coding assistants (Antigravity, Cursor, Claude Code, etc.) in following best practices when generating or modifying code.

Available Skills

1. tanstack-start-best-practices:
   • Server functions (createServerFn), Standard Schema input validation, isomorphic session checks, SSR hydration safety.
2. tanstack-router-best-practices:
   • Root context typing (createRootRouteWithContext), beforeLoad route guards, search parameter validation (validateSearch), and notFoundComponent / errorComponent handling.
3. tanstack-query-best-practices:
   • staleTime optimization, query key factory patterns, and optimistic UI mutations.
4. tanstack-integration-best-practices:
   • Seamless data flow coordination between TanStack Router, Query, and Start.

Installing Skills in Your Workspace

To add the TanStack Agent Skills to your project workspace:

npx -y skills add https://github.com/deckardger/tanstack-agent-skills

These are third-party skills pulled from GitHub, so they are versioned independently of Bunderstack.