GlassKit
The fullstack starter for Meta Ray-Ban Display apps: Vite glasses app, Next.js companion, Convex backend.
GlassKit is a production-grade pnpm + Turborepo monorepo for shipping apps to the Meta Ray-Ban Display Web Apps platform. It's three workspaces wired together, so you start on your product instead of on plumbing.
The architecture
Meta Web Apps are 600×600, single-screen, D-pad-navigated experiences. A heavyweight framework is the wrong tool for the glasses app, but you still need a full keyboard surface for sign-up and billing. So GlassKit splits cleanly:
app/
A Vite + React + TypeScript app. The 600×600 Meta Web App: <GlassViewport>, the D-pad focus system, the dark additive-display design system, and sensor hooks (motion, orientation, GPS, Neural Band gestures).
companion/
A Next.js 16 companion site. Marketing, Clerk sign-up, Stripe checkout, customer portal, account dashboard, same-network glasses pairing.
packages/backend/
A shared Convex backend. Schema, queries, Resend email actions, Stripe webhooks. Both apps talk to it.
What you get
- Production landing template: the companion ships as a
conversion-tuned, SEO-ready Next.js landing page. Swap one
lib/config.tsto rebrand for your product. Inter typography, Lighthouse-100 SEO, JSON-LD schemas, scroll reveals, mobile responsive - pnpm + Turborepo monorepo: one
pnpm install, workspaces forapp/,companion/, andpackages/backend/ - Vite glasses app: 600×600 viewport primitive, D-pad focus, additive-display design system, sensor hooks
- Clerk auth: sign-up on the companion, same-network pairing signs in the glasses after on-glasses approval
- Stripe payments: checkout, webhooks, customer portal
- Convex backend: real-time TypeScript database shared by both apps
- Convex components wired in: Stripe (checkout, portal, subscription sync), Resend (transactional email), Rate Limiter
- AI SDK in the backend: Anthropic + OpenAI via Vercel AI SDK, key stays server-side
- Six SDK + AI integration showcase demos (not finished products): AI Wayfinder, Tour Guide, Running Coach, Sous-Chef, Presentation Coach, Trail Companion. Each wires one sensor primitive to one AI call so you have a working starting point to fork
- AGENTS.md per workspace so Claude Code, Cursor, and Codex stay on-platform when they touch the glasses app
- GitHub Actions CI + production deploy configs for both apps
Who it's for
Indie hackers and small teams shipping apps to the Meta Ray-Ban Display platform. If you'd rather spend the first week building your product than wiring up Stripe webhooks for the fourteenth time, GlassKit is for you.
Heads-up on publishing
Meta hasn't opened public publishing yet. You can build, test on-device, and share with up to ~100 testers today; broad publishing opens later. GlassKit gets you fully built so you ship the day it does.
The 60-second path
git clone https://github.com/glasskitapp/glasskit-boilerplate my-app
cd my-app
pnpm install
cp .env.example .env.local
pnpm devThe site is now running at localhost:3000. The docs are at
localhost:3000/docs. Continue to the
Quickstart for the full setup including
payments and AI providers.