# Kernlift documentation > Kernlift is a TanStack Start SaaS template: authentication, billing, credits, an admin console, a > workspace, modules as plugins and an optional agent service, deployable to Cloudflare, Fly.io, > Railway or Docker. Inside a Kernlift project, `pnpm kernlift context` describes that project from its source (routes, plugins, settings pages, environment variables, scripts, validators, skills), and AGENTS.md holds the rules every change follows. Prefer those for project facts; use these pages for concepts and procedures. Every link below is the page as Markdown; https://kernlift.dev/llms-full.txt has all of them in one file. Chinese: https://kernlift.dev/zh/llms.txt. - [Introduction](https://kernlift.dev/docs.md): What Kernlift is, what the base repository contains, what the business templates add, and where to start. - **Guide** - [Get Kernlift](https://kernlift.dev/docs/guide/get-kernlift.md): Buy Kernlift Premium, activate it with your GitHub username, open the private repository, and buy business templates as a member or at list price. - [FAQ](https://kernlift.dev/docs/guide/faq.md): Activation, expired invitations, refunds, forking, syncing upstream updates, database changes after a sync, project limits and support. - [Architecture](https://kernlift.dev/docs/guide/architecture.md): How the code is layered, why business code never sees a SQL dialect, and the conventions that keep the template forkable. - [Prerequisites](https://kernlift.dev/docs/guide/prerequisites.md): The tools, accounts and background knowledge to have ready before you clone Kernlift. - [Sync upstream updates](https://kernlift.dev/docs/guide/upgrading.md): Merge new versions of the template into your project from the upstream remote, and accept them with the project's own checks. - [Troubleshoot a project](https://kernlift.dev/docs/guide/troubleshooting.md): Match a symptom to its cause and fix: setup gaps, session secret, generated types, migrations, development sign-in, the agent, scheduled jobs and repository access. - [Changelog](https://kernlift.dev/changelog) - **Quick start** - [Quick start](https://kernlift.dev/docs/quick-start.md): Clone the repository, install it, build the database, create the administrator and run the project locally. - **Customise** - [First steps after install](https://kernlift.dev/docs/customize/first-steps.md): Read the setup checklist, connect email, then choose which customisation guide to open next. - [Rebrand the project](https://kernlift.dev/docs/customize/branding.md): Replace the Kernlift name, URL, description, icons and share image with your own, and choose where people land after signing in. - [Replace the landing and pricing pages](https://kernlift.dev/docs/customize/landing-pages.md): Rewrite the example home page, add public pages from the page-shell primitives, and know what /pricing reads and what the validators enforce. - [Use the design system](https://kernlift.dev/docs/customize/design-system.md): Build or restyle a screen with beUI, the motion components and the product tokens, change the theme, and avoid the imports the validators reject. - [Add and change copy](https://kernlift.dev/docs/customize/i18n.md): Edit copy in English and Chinese, add a locale-aware route, and understand the optional locale segment and the i18n validators. - [Add an admin or workspace page](https://kernlift.dev/docs/customize/new-page.md): Add one screen under /admin or /app with a guarded server function, copy in both locales and a navigation entry. - **Deploy** - [Deploy your project](https://kernlift.dev/docs/deploy.md): Pick one of the four platforms, store the generated secrets, migrate, deploy, and create the production administrator. - [Deploy to Cloudflare Workers](https://kernlift.dev/docs/deploy/cloudflare.md): Deploy the Worker on D1 or on Postgres through Hyperdrive, store the session secret, create the production administrator, and optionally add the agent container. - [Deploy to Fly.io](https://kernlift.dev/docs/deploy/fly.md): Create the Fly app, import the generated secrets, deploy the Node image with migrations, create the production administrator, and optionally add the agent app. - [Deploy to Railway](https://kernlift.dev/docs/deploy/railway.md): Create the Railway project, services and Postgres from .railway/railway.ts, set the generated secrets, deploy, and create the production administrator. - [Deploy with Docker Compose](https://kernlift.dev/docs/deploy/docker.md): Run the project on your own server with compose.yaml: set the public URL, start the stack with migrations, put TLS in front, and create the production administrator. - [Run the Node build](https://kernlift.dev/docs/deploy/node.md): Build the Node server with pnpm build:node or the root Dockerfile, give it its environment, migrate, and run it on any host. - [Deployment model](https://kernlift.dev/docs/deploy/runtimes.md): One platform per project, two build targets, which databases and agent setups each platform allows, where secrets live, when migrations run, and how scheduled jobs are started. - **Core** - Configuration - [Configuration model](https://kernlift.dev/docs/core/configuration.md): Why a few settings live in environment variables and everything else lives in the database, edited in the admin console. - [Configure a working project](https://kernlift.dev/docs/core/configuration/project.md): Set startup variables, make sign-in and email work, then connect and verify the providers your product uses. - [Project structure](https://kernlift.dev/docs/core/project-structure.md): Find your way around a Kernlift checkout and know where each kind of change belongs. - Auth, roles and users - [Authentication and authorization model](https://kernlift.dev/docs/core/auth.md): Where identity is read, how access is decided at each boundary, and why there is no fallback user. - [Manage users, roles and permissions](https://kernlift.dev/docs/core/auth/roles.md): Each teammate holds a role with only the permissions their job needs, and you can suspend or ban any account. - [Users and accounts](https://kernlift.dev/docs/core/auth/users.md): Find an account, read what it holds, assign roles, ban and restore, and repair a credit balance. - [Issue API keys and set rate limits](https://kernlift.dev/docs/core/auth/api-keys.md): Users call the AI and upload endpoints from scripts with scoped keys, and you control how often each key may call them. - Admin console - [Run the admin console](https://kernlift.dev/docs/core/admin.md): Create the first administrator, finish the setup checklist, find your way around the sidebar, and use plugins, caching and the audit log from /admin. - [Audit log](https://kernlift.dev/docs/core/admin/audit-log.md): Read who changed what: 48 write paths record an actor, an action, a target and their metadata. - [Rate limits](https://kernlift.dev/docs/core/admin/rate-limits.md): Set the API-key request limits and choose an in-memory or Redis counter backend. - [View accounts and paid orders by country](https://kernlift.dev/docs/core/admin/countries.md): Compare account and settled-order totals by country over a date range. - [Cache](https://kernlift.dev/docs/core/admin/cache.md): Ten cache domains with their own TTLs, in memory or in Cloudflare KV, each clearable on its own. - [Data access](https://kernlift.dev/docs/core/data-access.md): How business code reaches the database: repositories only, one contract over SQLite, D1 and Postgres, what a transaction means on each, and why migrations are kept per dialect. - Plugins - [Plugins](https://kernlift.dev/docs/core/plugins.md): How the plugin kernel works: what a plugin is, the client and server slots it contributes to, how plugins are installed at build time and switched on and off at runtime. - [Write a console plugin](https://kernlift.dev/docs/core/plugins/console-plugins.md): Add a feature of your own as a local plugin: a workspace sidebar entry, a page and a dashboard card that an administrator can switch on and off. - [Templates and derived products](https://kernlift.dev/docs/core/plugins/templates.md): How a module differs from a template inside the repository, what the business templates are, and how a product of your own is built on the foundation by adding one plugin. - [Build a module](https://kernlift.dev/docs/core/plugins/build-a-module.md): Add a feature to the repository as a module: code, schema and migrations for both dialects, region markers, a manifest and a validator. - Background jobs - [Background jobs](https://kernlift.dev/docs/core/background-jobs.md): How the web app runs its own periodic work once a minute on every platform, why one lock row is enough, and how /setup detects when it stopped. - [Run background jobs](https://kernlift.dev/docs/core/background-jobs/run.md): Make sure the scheduled jobs run on your platform, run a round by hand, and act on the warning /setup shows when they stop. - [Validators and the release gate](https://kernlift.dev/docs/core/validators.md): Why every capability carries an executable check that asserts behaviour and wiring, and how the release gate decides which checks must pass. - [Use coding-agent skills](https://kernlift.dev/docs/core/agent-skills.md): Use the SKILL.md workflows in skills/ to learn a project, create projects, build, install and remove modules, add pages, configure providers and deploy. - **Extensions** - Database - [Use Postgres and Supabase](https://kernlift.dev/docs/extensions/database/postgres.md): Point the app at any Postgres database, including Supabase and Neon, and build its schema from the migration chain. - [Supabase](https://kernlift.dev/docs/extensions/database/supabase.md): Run the application database on Supabase. - [Neon](https://kernlift.dev/docs/extensions/database/neon.md): Run the application database on Neon. - [Use Turso](https://kernlift.dev/docs/extensions/database/turso.md): Run the app on a Turso libSQL database through the SQLite schema branch and the turso adapter. - [Write a custom database adapter](https://kernlift.dev/docs/extensions/database/custom-adapter.md): Register your own connection for the Postgres or SQLite schema family and select it with DATABASE_ADAPTER. - Login and auth providers - [Set up email and password sign-in](https://kernlift.dev/docs/extensions/auth/email-password.md): Users can create an account, verify their email address, sign in and reset a forgotten password. - [Add Google and GitHub sign-in](https://kernlift.dev/docs/extensions/auth/social.md): The sign-in and sign-up pages show a Google or GitHub button that signs users in through their existing account. - [Google](https://kernlift.dev/docs/extensions/auth/google.md): Let buyers sign in with Google. - [GitHub](https://kernlift.dev/docs/extensions/auth/github.md): Let buyers sign in with GitHub. - Payments - [Payment lifecycle](https://kernlift.dev/docs/extensions/payments.md): How a checkout becomes a paid order: server-side pricing, provider confirmation by webhook or callback, idempotent settlement and refunds. - [Connect a payment provider](https://kernlift.dev/docs/extensions/payments/setup.md): Buyers pay on Stripe, Creem, PayPal, DodoPayments, WeChat Pay, Alipay or Waffo, and a confirmed payment marks their order paid. - [Stripe](https://kernlift.dev/docs/extensions/payments/stripe.md): Take one-time payments and monthly or yearly subscriptions through Stripe Checkout, with refunds and the customer portal. - [Creem](https://kernlift.dev/docs/extensions/payments/creem.md): Accept payments with Creem. - [PayPal](https://kernlift.dev/docs/extensions/payments/paypal.md): Accept payments with PayPal. - [DodoPayments](https://kernlift.dev/docs/extensions/payments/dodopayments.md): Accept payments with DodoPayments. - [WeChat Pay](https://kernlift.dev/docs/extensions/payments/wechat-pay.md): Accept payments with WeChat Pay. - [Alipay](https://kernlift.dev/docs/extensions/payments/alipay.md): Accept CNY payments on Alipay's computer-website cashier. - [Waffo](https://kernlift.dev/docs/extensions/payments/waffo.md): Accept payments through Waffo, a merchant of record that collects and remits sales tax. - [Sell products and plans](https://kernlift.dev/docs/extensions/payments/products.md): Your products appear on the storefront with a price; buying one issues a licence the buyer activates with a GitHub username. - [Manage pricing plans](https://kernlift.dev/docs/extensions/payments/pricing-plans.md): Create and edit the plans the pricing page lists and checkout sells, in every language, from the admin console. - [Manage orders, refunds and subscriptions](https://kernlift.dev/docs/extensions/payments/subscriptions.md): You can refund an order, cancel or resume a subscription, let buyers manage their billing and re-apply a failed webhook. - [Write a fulfilment plugin](https://kernlift.dev/docs/extensions/payments/fulfilment.md): Deliver what a paid order buys from your own plugin, refuse checkouts you cannot fulfil, and see a failed delivery retried. - Storage - [Set up file storage and uploads](https://kernlift.dev/docs/extensions/storage.md): Users can upload files and download them through time-limited links, stored in your own S3-compatible bucket or R2 binding. - [Cloudflare R2](https://kernlift.dev/docs/extensions/storage/cloudflare-r2.md): Store uploaded files with Cloudflare R2. - [Amazon S3](https://kernlift.dev/docs/extensions/storage/aws-s3.md): Store uploaded files with Amazon S3. - [MinIO](https://kernlift.dev/docs/extensions/storage/minio.md): Store uploaded files with MinIO. - Email - [Send transactional email](https://kernlift.dev/docs/extensions/email.md): Verification, password reset and your own product emails are delivered through Resend, Cloudflare Email Service or Aliyun DirectMail from templates you can edit. - [Resend](https://kernlift.dev/docs/extensions/email/resend.md): Send transactional email with Resend. - [Cloudflare Email](https://kernlift.dev/docs/extensions/email/cloudflare.md): Send transactional email with Cloudflare Email. - [Aliyun DirectMail](https://kernlift.dev/docs/extensions/email/aliyun.md): Send transactional email with Aliyun DirectMail. - Analytics - [Add analytics and support chat](https://kernlift.dev/docs/extensions/analytics.md): Load Google Analytics, Umami, Plausible, Clarity or the Crisp chat widget on every page, check the connection and read statistics by country. - [Google Analytics](https://kernlift.dev/docs/extensions/analytics/google-analytics.md): Connect your website to Google Analytics. - [Google Ads](https://kernlift.dev/docs/extensions/analytics/google-ads.md): Connect your website to Google Ads. - [Umami](https://kernlift.dev/docs/extensions/analytics/umami.md): Connect your website to Umami. - [Plausible](https://kernlift.dev/docs/extensions/analytics/plausible.md): Connect your website to Plausible. - [Microsoft Clarity](https://kernlift.dev/docs/extensions/analytics/clarity.md): Connect your website to Microsoft Clarity. - [Crisp](https://kernlift.dev/docs/extensions/analytics/crisp.md): Connect your website to Crisp. - AI - [AI channels, scenes and task lifecycle](https://kernlift.dev/docs/extensions/ai.md): How providers, provider scenes and scenes fit together, how a price in credits is resolved, and how tasks and chat run from request to settlement. - [Connect an AI provider](https://kernlift.dev/docs/extensions/ai/providers.md): An upstream AI account and its models are saved in the admin console and ready to be routed to your scenes. - [OpenAI](https://kernlift.dev/docs/extensions/ai/openai.md): Route text generation to OpenAI. - [Google Gemini](https://kernlift.dev/docs/extensions/ai/gemini.md): Route text generation to Google Gemini. - [Cloudflare Workers AI](https://kernlift.dev/docs/extensions/ai/workers-ai.md): Route text generation to Cloudflare Workers AI. - [Route scenes and set pricing](https://kernlift.dev/docs/extensions/ai/scenes.md): Your product exposes named AI scenes such as chat or image-creation, each routed to a model and priced in credits. - [Receive async results (polling and webhooks)](https://kernlift.dev/docs/extensions/ai/async.md): Image, video and audio tasks that finish later reach a final status, and their credits are charged or returned. - [Get image and video generation working](https://kernlift.dev/docs/extensions/ai/media-generation.md): Wire an image or video provider so a generation completes end to end: request variables, array parser paths, status polling, storage of the result, and the picture or clip shown in the agent conversation. - [Chat conversations](https://kernlift.dev/docs/extensions/ai/chats.md): Read the conversations your users had with an agent: who, which agent, in which language, and every message part. - Credits - [Credits ledger](https://kernlift.dev/docs/extensions/credits.md): How credits are stored as an append-only ledger with a balance snapshot, and how hold, capture and refund keep metered charges accurate. - [Charge usage with credits](https://kernlift.dev/docs/extensions/credits/usage.md): Users hold a credit balance from plans or grants, and metered work such as AI tasks is paid from it. - [Publish content with the CMS](https://kernlift.dev/docs/extensions/cms.md): Write, publish and organise blog posts, legal pages, a changelog and a roadmap in English and Chinese from the admin console. - Newsletter - [Newsletter and waitlist](https://kernlift.dev/docs/extensions/newsletter.md): Collect newsletter subscribers and a launch waitlist, sync them to Resend or Beehiiv, invite people in batches and retry failed syncs. - [Resend](https://kernlift.dev/docs/extensions/newsletter/resend.md): Sync newsletter subscribers with Resend. - [Beehiiv](https://kernlift.dev/docs/extensions/newsletter/beehiiv.md): Sync newsletter subscribers with Beehiiv. - [Run an affiliate program](https://kernlift.dev/docs/extensions/affiliate.md): Set the program terms, give partners referral codes, turn their orders into commissions and review payouts in the admin console. - [Support tickets](https://kernlift.dev/docs/extensions/support.md): Take support requests from signed-in customers, triage them against an SLA and reply from the admin console. - Notifications - [Send notifications to Slack, Discord or Feishu](https://kernlift.dev/docs/extensions/notifications.md): Operations alerts from your product arrive in a team chat channel, with every attempt recorded in a delivery log. - [Slack](https://kernlift.dev/docs/extensions/notifications/slack.md): Send team notifications to Slack. - [Discord](https://kernlift.dev/docs/extensions/notifications/discord.md): Send team notifications to Discord. - [Feishu](https://kernlift.dev/docs/extensions/notifications/feishu.md): Send team notifications to Feishu. - Agent - [Agent runtime](https://kernlift.dev/docs/extensions/agent.md): How the optional agent service is deployed, how the web app decides whether it is available, and how a run, its workspace, skills and decisions fit together. - [Run the agent starter](https://kernlift.dev/docs/extensions/agent/starter.md): Install the agent template, configure its model channels, sandbox and search providers, start the agent service and open the workbench. - [E2B](https://kernlift.dev/docs/extensions/agent/e2b.md): Connect the agent service to E2B. - [Alibaba Cloud Sandbox](https://kernlift.dev/docs/extensions/agent/aliyun.md): Connect the agent service to Alibaba Cloud Sandbox. - [Novita Sandbox](https://kernlift.dev/docs/extensions/agent/novita.md): Connect the agent service to Novita Sandbox. - [SearXNG](https://kernlift.dev/docs/extensions/agent/searxng.md): Connect the agent service to SearXNG. - [Crawl4AI](https://kernlift.dev/docs/extensions/agent/crawl4ai.md): Connect the agent service to Crawl4AI. - [Agent plugins](https://kernlift.dev/docs/extensions/agent/plugins.md): Build an agent capability as a plugin: it joins the one workbench composer, adds its own cards, panels and operations, and switches on and off at runtime without host changes. - [Image agent](https://kernlift.dev/docs/extensions/agent/image-agent.md): Add an image agent to the workbench: requests run an image Skill on the agent runtime, in the frame the reader picks, with a per-run picture limit you set. - **Reference** - [What the base repository contains](https://kernlift.dev/docs/reference/capabilities.md): The foundation, the modules that ship with it and the agent stack: what each part adds and what it needs. - [Skills](https://kernlift.dev/docs/reference/skills.md): The SKILL.md workflows in skills/: what each one does, what it asks you for and how it confirms the work is done. - [Scripts](https://kernlift.dev/docs/reference/scripts.md): Every pnpm script in the template's package.json except the individual validators, grouped by what you use it for. - [Validators](https://kernlift.dev/docs/reference/validators.md): Every validate:* script, what it proves, whether validate:all and the release gate run it, and which ones are known to fail. - [Environment variables](https://kernlift.dev/docs/reference/env.md): The six variables a deployment needs, the few optional ones, and the variables only the agent service and the scripts read. - [Deployment configuration](https://kernlift.dev/docs/reference/deploy-config.md): deploy.config.json and the kernlift deploy-target command that rewrites it: the combinations it allows, the files each platform owns, the keys of .env.production, and how each platform migrates and bootstraps.