v260414.01 2:55p
AlpacApps — AI-powered platform with alpacas

AlpacApps Infra

Set up a full-stack freely hosted AI-powered platform in 30 – 90 minutes for most. Claude walks you through every step — adapting to your computer, your accounts, and what you want to build. Just install Claude and paste one prompt.

$20 – $200 / month

0 Install prerequisites 5 min

On Mac, open Terminal (press + Space, type "Terminal", hit Enter) and paste this command to install everything Claude needs (git, GitHub CLI, Node.js, Supabase CLI, Wrangler, psql, TypeScript):

bash <(curl -fsSL https://alpacaplayhouse.com/scripts/install-prereqs.sh)

Or if you already cloned the repo: bash scripts/install-prereqs.sh — or brew bundle (uses the Brewfile).

Not on Mac? Install Git, Node.js, and GitHub CLI manually. The setup wizard handles the rest.

Note: Xcode Command Line Tools must be installed first (xcode-select --install). The script checks for this.

1 Install Claude Desktop 2 min

Claude Desktop is your AI assistant. You'll start in Claude Chat to walk through setup, then switch to Claude Code (built into the same app) once your project is cloned locally.

Download Claude Desktop

Free to start — Pro ($20/mo) or Max ($100/mo) recommended. Sign up at claude.ai if you don't have an account.

2 Copy & paste this prompt into Claude Chat 30 sec

Open Claude Desktop and start a new Chat conversation. Paste this prompt — Claude Chat will guide you through everything step by step, including installing tools, creating accounts, and cloning the repo.

Set up an AlpacApps project for me. Read the instructions at https://alpacaplayhouse.com/infra/llm-setup-instructions.md and walk me through it step by step.

Claude Chat will guide you through screenshots, Git, GitHub, and everything else based on your specific computer. Once the repo is cloned, Claude will tell you to switch to the Code tab for the rest of the setup.

3 Claude guides you through setup 20–30 min

Follow along as Claude walks you through each step. Paste screenshots when asked — Claude will verify you’re on the right page and tell you exactly what to click.

Screenshots & tools Sets up one-click screenshots for your OS
GitHub & repository Creates your repo and enables Pages hosting
Supabase database Sets up your database, auth, and storage
Claude Code Your AI developer that writes and deploys code
Cloudflare Domain management + D1 session logging

4 Get your Cloudflare key 2 min

Cloudflare manages your domain’s DNS and provides a D1 database for session logging. You only need two things:

  1. Your Cloudflare email — the one on your account
  2. Global API Key — go to Profile → API Tokens, find “Global API Key”, click “View”

That’s it. Claude uses this key once to create a scoped project token with only the permissions your project needs — then uses that for all ongoing operations.

When you're done

Your project will be live with:

From there, just open Claude Code and tell it what you want to build. It handles all the code, commits, and deploys.

Two project profiles

Property Management

Full stack — spaces, tenants, devices, events, smart home, bookings. Everything you need to run a rental property or co-living space.

General AI Enablement

Core framework — auth, payments, email, permissions, web pages. Build a SaaS, personal tool, booking system, CRM, portfolio, or side project.

Both use the same template. The setup wizard tailors the project to your choice — removing unused code and generating focused documentation.

What can you build with this?
Your Customers & Partners
Consumers Banks/Payment Systems External Services
Capabilities
User Login Email SMS Payments E-Signatures AI Features Smart Home Voice Calling QA Testing
Google OAuth • Resend • Telnyx • Stripe • PayPal • Square • SignWell • Gemini • HAOS • gstack
Your Business
CRM & customer management — contacts, relationships, communications, documents, payments
Foundation
Database + Auth + Storage Website + Hosting Tailwind CSS v4
Supabase • Cloudflare Pages • Tailwind • Free

AlpacApps Component Services

Click checkboxes for cost estimate

Learn more

Free static site hosting via Cloudflare’s global CDN. Every git push to main deploys automatically — no build step, no server to manage.

  • How it works: Your HTML, CSS, and JavaScript files are built and served from Cloudflare’s edge network. Cloudflare handles SSL, CDN, and uptime.
  • Limits: 500 deploys/month, unlimited bandwidth, unlimited requests (generous — most sites never hit deploy limits).
  • Custom domains: Add any domain in the Cloudflare Pages dashboard with free HTTPS automatically.

Go to Cloudflare Pages →

Learn more

Open-source Firebase alternative that replaces an entire backend. One service gives you a PostgreSQL database, user authentication, file storage, and serverless edge functions.

  • Database: Full PostgreSQL with Row Level Security — your browser talks directly to the database, and RLS ensures users only see their own data.
  • Auth: Built-in Google OAuth, magic links, and email/password. 50,000 monthly active users on the free tier.
  • Storage: 1 GB free for photos, documents, and media with public/private access policies.
  • Edge Functions: Serverless TypeScript functions for webhooks, API integrations, and anything that needs server-side logic (Stripe, Telnyx, etc.).
  • Free tier: 500 MB database, 1 GB storage, 500,000 edge function calls/month.

Go to Supabase →

Learn more

Cloudflare manages your domain’s DNS and provides a D1 serverless database for session logging. Claude sets everything up using your Global API Key.

  • DNS management: Authoritative DNS for your domain. Claude configures records for Cloudflare Pages, custom domains, and any other services.
  • D1 database: Serverless SQLite for logging Claude Code sessions — tracks what was built, when, and by which agent.
  • R2 storage: If you need object storage (images, files), Claude creates an R2 bucket using the same Cloudflare token.
  • Setup: Just provide your Cloudflare email and Global API Key. Claude creates a scoped project token automatically.

Go to Cloudflare →

Learn more

AI-powered developer by Anthropic that writes, tests, and deploys your code. It reads your project’s CLAUDE.md file to understand your codebase, conventions, and architecture.

  • What it does: Writes HTML/CSS/JS, creates database tables, deploys edge functions, configures services, commits and pushes to GitHub — all from natural language instructions.
  • How you use it: Describe what you want in plain English; Claude Code handles the implementation, commits, and deploys.
  • Plans: Free tier (daily limits), Pro ($20/mo, recommended), Max ($100/mo for heavy building), Max+ ($200/mo for intensive development).

Go to Claude Code →

Learn more

“Sign in with Google” powered by Supabase Auth. Users authenticate with their Google account — no passwords to store or manage.

  • Setup: Create a Google Cloud project, get OAuth credentials, enable the Google provider in Supabase. The setup wizard handles the code.
  • How it works: One-click Google login redirects through Supabase, which creates a user record and returns a session token. Your app checks the token to gate admin pages.
  • Use cases: Admin dashboards, customer portals, any page that needs user accounts.

Go to Google Cloud Console →

Learn more

Modern transactional email API. Send welcome emails, booking confirmations, payment receipts, and custom notifications.

  • Free tier: 3,000 emails/month with a verified domain (or use onboarding@resend.dev for testing).
  • How it integrates: A Supabase edge function (send-email) handles outbound mail. Your app calls the function with a template name and data.
  • Inbound email: Webhook support lets you receive and process incoming emails (e.g., reply-to-ticket workflows).

Go to Resend →

Learn more

Open-source toolkit that supercharges Claude Code with a headless browser and pre-built skills for common workflows.

  • QA testing: /qa systematically tests your site, finds bugs, fixes them, and verifies the fixes — all automatically.
  • Code review: /review analyzes your diff for SQL safety issues, trust boundary violations, and structural problems before you merge.
  • Ship workflow: /ship runs tests, reviews the diff, bumps version, updates changelog, and creates a PR in one command.
  • Headless browser: Navigate pages, click elements, take screenshots, verify deployments — ~100ms per command.

Go to gstack →

Learn more

SMS messaging API for sending text notifications to users — booking reminders, access codes, payment alerts.

  • Cost: ~$0.004/message outbound, ~$1/month for a dedicated phone number.
  • Two-way messaging: Inbound webhook lets users reply to texts and trigger actions in your app.
  • How it integrates: A Supabase edge function (send-sms) sends messages. Telnyx webhooks post inbound messages to another edge function.

Go to Telnyx →

Learn more

Payment processing with both online and in-person support. Good for businesses that also have a physical location with a Square terminal.

  • Pricing: 2.9% + 30¢ per online transaction. No monthly fee.
  • Sandbox: Full test environment with fake cards — build and test before going live.
  • How it integrates: Square webhook posts payment events to a Supabase edge function. Your app creates payment links via the Square API.

Go to Square →

Learn more

The most popular payment platform, with excellent ACH bank transfer pricing and support for marketplace-style payouts.

  • ACH: 0.8% per transfer, capped at $5 — ideal for rent collection or high-value transactions.
  • Cards: 2.9% + 30¢ per charge.
  • Stripe Connect: Split payments between multiple parties (e.g., property owner gets 90%, management fee is 10%).
  • How it integrates: Stripe webhook posts events to a Supabase edge function. Your app creates checkout sessions and payment links via the Stripe API.

Go to Stripe →

Learn more

Accept payments via PayPal and send payouts to associates. Works alongside Stripe and Square for maximum payment flexibility.

  • Checkout: Buyers pay with PayPal balance, cards, or Venmo. 2.9% + 30¢ per transaction.
  • Payouts: Send money to vendors and associates via the PayPal Payouts API — instant to their PayPal account.
  • How it integrates: Three Supabase edge functions handle checkout, payouts, and webhooks. Config stored in paypal_config table.

Go to PayPal Developer →

Learn more

Electronic signatures for leases, contracts, and agreements. Send documents for signing from your app and get notified when they’re completed.

  • Free tier: 3–25 documents/month depending on plan.
  • How it works: Your app sends a document via the SignWell API. The signer receives an email, signs in their browser, and a webhook notifies your app when it’s done.
  • Templates: Create reusable templates with placeholder fields that get filled automatically from your database.

Go to SignWell →

Learn more

Add AI-powered features to your app using Google’s Gemini models. Chat assistants, content generation, image analysis, and smart matching.

  • Free tier: 1,000 requests/day — generous for most applications.
  • How it integrates: Gemini API key is stored as a Supabase secret. Edge functions call Gemini for server-side AI tasks. Client-side JS can also call Gemini directly for chat interfaces.
  • Use cases: AI chat assistant, auto-generate listing descriptions, analyze photos, match tenants to spaces, summarize documents.

Go to Google AI Studio →

Learn more

S3-compatible object storage with generous free tier and zero egress fees — you never pay for downloads.

  • Free tier: 10 GB storage, 1 million reads/month, 10 million writes/month.
  • Zero egress: Unlike AWS S3, downloading files costs nothing. Ideal for serving media, PDFs, and documents.
  • When to use: For files that don’t need Supabase Storage’s row-level security — public media, manuals, marketing assets. Use Supabase Storage for private/user-scoped files.

Go to Cloudflare →

Learn more

Serverless SQL database from Cloudflare for archiving your Claude Code session transcripts.

  • What it stores: Every Claude Code conversation — what you asked, what was built, what files changed. Searchable development history.
  • Why it’s useful: Find “how did we build the payments page?” months later. Great for onboarding new team members or debugging past decisions.
  • Free tier: 5 GB storage, 5 million reads/day. More than enough for session transcripts.

Go to Cloudflare →

Learn more

A personal knowledge management system that gives every AI assistant — Claude, ChatGPT, Cursor — access to the same unified brain. Type a thought into Slack, and it’s instantly embedded, classified, and retrievable by any connected tool.

  • Capture: Messages in a private Slack channel are automatically embedded, classified, and stored — with people, action items, and tags extracted automatically.
  • Retrieve: An MCP server lets any AI assistant semantically search your brain and write to it using a single URL. Meaning-based, not keyword matching.
  • Multi-AI: One knowledge base shared across Claude Code, ChatGPT, Cursor, and any MCP-compatible tool.
  • No local dependencies: Runs entirely on Supabase + OpenRouter + Slack. No servers to maintain.

Based on Nate’s Newsletter

Learn more

Always-on cloud VPS for background tasks that can’t run in the browser or in serverless edge functions.

  • What runs here: Device pollers (Tesla, LG, cameras), OpenClaw (3D printer/laser cutter proxy), AI image generation, automated bug fixer, and webhook processors.
  • Options: Hostinger VPS ($5–12/mo, recommended) or Oracle Cloud (free ARM tier — always free, 4 vCPU, 24 GB RAM).
  • When you need it: Only if you have smart home devices, vehicles, maker tools, or other integrations that need continuous background polling. Most projects don’t need this.

Go to Hostinger →

Learn more

Use your own branded URL (e.g., yoursite.com) instead of username.github.io.

  • Cost: ~$10/year from any domain registrar (Cloudflare, Namecheap, Google Domains).
  • Setup: Add your domain in the Cloudflare Pages project settings. Cloudflare configures DNS and provides free HTTPS automatically.
  • When to get one: Before sharing your site publicly. You can always add a domain later without breaking anything.

Go to Cloudflare Registrar →

Learn more

Native iOS app built with Swift and SwiftUI. Full access to push notifications, camera, GPS, biometrics, and all native APIs.

  • Native performance: Built with SwiftUI for smooth 60fps animations, native navigation, and platform-idiomatic UI. Screens for lights, music, climate, cameras, vehicles, and more.
  • Shared API layer: Connects to the same Supabase backend and Home Assistant APIs as the web app.
  • Cost: Apple Developer Program ($99/yr). Requires a Mac with Xcode to build.

Go to Apple Developer →

Learn more

Native Android app built with Kotlin and Jetpack Compose. Full Material 3 design with native performance.

  • Native performance: Built with Jetpack Compose for native Android UI. Screens for lights, music, climate, cameras, vehicles, and an AI assistant.
  • Build anywhere: Android Studio runs on macOS, Windows, and Linux — no Mac required.
  • Cost: Google Play Console is a $25 one-time fee (not annual).

Go to Google Play Console →

Learn more

Add AI-powered voice calling to your app. Create phone agents that answer calls, make outbound calls, and handle conversations with natural language.

  • How it works: VAPI handles the phone infrastructure. Your Supabase edge function (vapi-webhook) processes call events and transcripts.
  • Use cases: Automated appointment reminders, AI receptionist, property inquiry hotline, emergency notification calls.
  • Config: API key and assistant settings stored in vapi_config table.

Go to VAPI →

Learn more

An AI-powered Discord bot that bridges your community server to your platform’s AI assistant. Users can chat with PAI, ask questions about the property, and trigger actions.

  • How it works: A Node.js worker (pai-discord) listens for messages and forwards them to the alpaca-pai Supabase edge function.
  • Runs on: Your background worker VPS as a systemd service.
  • Cost: Free — Discord bot accounts are free to create and run.

Go to Discord Developer Portal →

Learn more

A dedicated Mac on your local network that bridges LAN-only smart home devices to your cloud app. Runs Home Assistant OS (HAOS) as the central smart home hub.

  • What it runs: Home Assistant (HAOS — 30+ smart devices across WiZ, Govee, Tuya/SmartLife), Sonos HTTP API (music control), go2rtc (camera streams), Music Assistant, Blink camera poller, and device pollers.
  • How it connects: Tailscale VPN links the Mac to your cloud services. A reverse proxy (Hostinger or similar) routes external requests to the Mac.
  • Cost: A used Mac Mini runs ~$150 one-time. Low power draw (~10W idle).
  • When you need it: Only for smart home features (Sonos, cameras, climate control). Not needed for standard web apps.

Go to Mac Mini →

How much will you build?

This mainly affects your Claude Code plan and usage-based services.

Estimated annual cost $0

AlpacApps Architecture

67 edge functions, 11 workers, 2 native mobile apps — zero backend code

Claude Code Supabase Cloudflare Pages Alpaca Mac Hostinger
Residents / Admins / Public HTTPS CF Cloudflare Pages Static HTML/JS/CSS hosting alpacaplayhouse.com /spaces/ /residents/ /admin/ /auth/ API calls SB Supabase Backend-as-a-Service (database, auth, storage, edge functions) PostgreSQL Auth Storage Edge Functions CC Claude Code AI dev agent: writes code, fixes bugs, deploys, runs SQL Local or cloud (Claude Max/Pro) git push migrations Mac Alpaca Mac On-prem home server. Bridges LAN-only smart home devices Sonos go2rtc HomeA MusicA Tailscale VPN HG Hostinger VPS Reverse proxy + tunneling. Routes cloud traffic to LAN Caddy Tailscale PAI-Claw Edge Fn proxy Tailscale mesh External APIs Stripe Resend Tesla Telnyx SignWell Govee Gemini Vapi Nest Brave LG ThinQ Anova webhooks + API calls ZERO SERVER ARCHITECTURE Browser talks directly to Supabase RLS enforces security at DB level

How a request flows

01
Browser
User loads page from Cloudflare Pages
02
Supabase
JS calls Supabase API (auth + data)
03
Edge Function
Sensitive ops run server-side
04
Hostinger
Proxies to LAN via Tailscale
05
Alpaca Mac
Controls Sonos, cameras, lights

View in full setup guide →

🔄 Stay Updated

Already set up? New features get added to the template regularly. Run this prompt once a month to see what's new and adopt features you want:

Read https://alpacaplayhouse.com/infra/updates.html and help me adopt any new features that have been added since I last set up my project. Check what I already have and only offer what's new.

Or browse the updates page directly to pick and choose.