Introduction

Welcome to the Spacerr documentation. This is the place to get started with the starter kit, learn about the codebase structure, understand its features, and see how to use it.

What is Spacerr?

Spacerr is a production ready AI SaaS starter built with Next.js, React, Prisma, Better Auth, Stripe, Vercel AI SDK, Vercel Blob, Resend, Pusher, Redis, PostHog, Tailwind CSS, and shadcn/ui.

It is designed as a real application foundation rather than an empty template. The main surfaces are already wired together, so you can focus on the product idea, pricing, content, and workflows instead of rebuilding common SaaS plumbing.

The app includes a public marketing site, AI chat workspace, saved conversations, projects, file uploads, a private library, billing, admin tools, blog publishing, SEO foundations, transactional email, and account settings.

Codebase Structure

The codebase is a single Next.js App Router application with feature owned modules.

1. src/app contains routes, layouts, route handlers, and framework wiring.
2. src/features contains product domains such as AI chat, projects, billing, admin, blog, and authentication.
3. src/components contains shared layout, product UI, and reusable UI primitives.
4. src/lib contains shared infrastructure such as routes, environment validation, HTTP helpers, SEO helpers, auth, database, and provider clients.
5. src/providers contains the root provider stack for theme, query state, analytics, and app level behavior.

App Architecture

Spacerr uses the Next.js App Router as the application shell. Public pages, dashboard pages, auth flows, API routes, sitemap, robots, RSS, and llms.txt live under src/app.

Most business logic lives under src/features. A feature owns its components, hooks, API clients, schemas, repositories, actions, constants, tests, and types. Shared infrastructure is kept in src/lib, while reusable visual primitives live in src/components.

The Database section owns the database provider, schema, and workflow details. Server code reads validated values from src/lib/env.server.ts, and browser code reads validated public values from src/lib/env.client.ts.

Frequently Asked Questions

Is this only a UI template?

No. Spacerr is a working SaaS foundation with real product flows: auth, billing, admin tools, AI chat, file handling, SEO, persistence patterns, and production API routes.

Is the AI chat workspace included?

Yes. The AI workspace includes persistent chats, project workspaces, file attachments, streaming responses, feedback, regeneration, context handling, and tool workflows.

Can I use different AI models?

Yes. The AI layer is built around provider and model flexibility through Vercel AI SDK and AI Gateway style patterns, so you can switch models and extend tools without rebuilding the workspace.

Can I customize the design?

Yes. It is built with Tailwind and shadcn style components, so you can rebrand the interface, adjust layouts, and shape the product around your own idea.

What can I build with it?

You can build AI SaaS products, internal AI tools, copilots, document assistants, workflow assistants, dashboards, developer tools, niche SaaS products, or simple marketing pages for your web app. The public site already includes the pages, SEO, styling, and content structure you need, so you can remove the dashboard route and use it as a ready marketing foundation.

Does it include billing and auth?

Yes. Better Auth flows, protected routes, account pages, roles, Stripe checkout, monthly subscription examples, yearly subscription examples, one time payment examples, billing status patterns, and production focused API boundaries are included.

Is the marketing site included?

Yes. It includes the homepage, pricing flow, integrations section, blog, legal pages, SEO metadata, sitemap, robots, RSS, and JSON LD patterns.

How is this different from other boilerplates?

Most starter kits stop at SaaS basics. Spacerr includes those basics plus a working AI product workspace with project flows, files, tool workflows, admin, SEO, and product grade patterns.

Who is this for?

Spacerr is for AI SaaS founders, indie hackers, agencies, product teams, solo developers, startup teams, consultants, freelancers, technical founders, and developers building AI powered products, internal tools, client projects, or marketing sites without rebuilding the same foundation from scratch.

Can I use Spacerr for multiple projects?

Yes. The license is designed for multiple projects within your plan. Solo covers unlimited personal projects, Pro covers team projects, and Agency covers client builds.

Is this beginner friendly?

It is beginner friendly for developers comfortable with React and Next.js, but it is still a serious production focused foundation, not a no code tool.