# PyNuxt

PyNuxt — All batteries included — your project is just a prompt away.

Ship your MVP, SaaS, or product in days, not months. PyNuxt gives you all you need to get your idea done. From strong foundations up to deployment in the cloud. Don't guess the foundations, focus on your product and your users. With PyNuxt, you can start coding your product from day one, and be confident that it's built on a solid, production-ready base.

## What is PyNuxt

PyNuxt is a boilerplate for production-ready, vibe coding-first projects. It includes everything you need to get started, including a powerful backend, a sleek frontend, and a comprehensive set of tools for development and deployment with best practices in mind. Don't vibe code from scratch, start with strong foundations and your project will be ready for production from day one.

## Stack
- Frontend: Nuxt (TypeScript, SSR)
- Backend: FastAPI (Python)
- Database: PostgreSQL
- Infrastructure: Terraform (DigitalOcean)
- Local orchestration: Docker Compose

## Features

### AI-First Development (Developer Experience)
PyNuxt ships with a structured agent file system — CLAUDE.md, SPEC.md, DESIGN.md — designed to make AI tools like Claude Code instantly productive in your codebase. No more context-dumping before every session. Your agents know the rules, patterns, and constraints from day one.

### Pure Python Backend
The backend is a clean FastAPI application — typed, async, and built to scale. No framework sprawl. The Nuxt server layer is intentionally thin, handling only what requires server-side cookies. Everything else lives in Python, where it belongs.

### Nuxt-Powered Frontend
A fully-typed Nuxt application with SSR, i18n, dark/light theming, and a component system built around reusability. From the layout system to the UI kit, everything is consistent, accessible with ARIA roles, and ready to extend without rewriting what's already there.

### Web3 Ready Out of the Box
Full Web3 support, front to back. Users get Safe smart wallets powered by Safe with social login fallback, while you get a clean Solidity development environment.

### Datadog — No Errors Go Unnoticed (Observability)
Datadog RUM and error tracking are wired in from day one. Every frontend exception is captured, tagged, and routed to your Datadog dashboard automatically. No extra instrumentation. No silent failures.

### PostHog — Track Users and LLM Usage (Analytics)
PostHog is integrated for product analytics and LLM observability. Track feature adoption, user funnels, and AI call performance in one place.

### Deploy on DigitalOcean, Leave Anytime (Infrastructure)
Terraform configs for DigitalOcean's App Platform are included and ready to apply. But because everything runs in Docker, you're never locked in — migrate to any cloud or self-host with a single compose file.

### iOS & Android with Capacitor (Mobile)
Turn your Nuxt app into a native iOS and Android app — no React Native, no Expo, no rewrite. PyNuxt ships with Capacitor pre-configured, per-environment build scripts, and deep-link support baked in. One codebase, web and mobile from day one.

### Stripe, SendGrid, Twilio — and More (Integrations)
PyNuxt bundles the integrations every production app eventually needs: Stripe for payments and subscriptions, SendGrid for transactional email, Twilio for SMS verification, and more. Each is wired into the backend, typed end-to-end, and ready to use without configuration archaeology.

## Pricing
One-time payment, no subscriptions, no seat fees. You receive the exact PyNuxt codebase this page is built on — every integration pre-wired, every pattern already in place. Start building your product on day one instead of assembling infrastructure for weeks. Private GitHub repository access granted after purchase.

## Pages
- `/` — landing page
- `/blog` — blog index and posts
- `/terms` — Terms of Service