meteor-speedrun-ai-template

Production-ready Meteor starter with a working prompt marketplace demo. Clone, customize, ship.

What's Included

• User Authentication — Email/password via accounts-password
• Server-Side Rendering — Full HTML on first load, SEO-friendly
• Prompt Marketplace Demo — Browse, purchase, sell prompts (example CRUD)
• Dashboard — User prompts, purchases, account management
• Atomic Design — Enforced component hierarchy (see docs/ATOMIC_DESIGN.md)
• SEO Ready — Dynamic meta tags, sitemap, robots.txt, proper HTTP status codes
• AI-Friendly — AGENTS.md with rules for Cursor, Windsurf, Copilot

Quick Start

Prerequisites: Node.js 20+, Meteor 3.x

meteor create --from https://github.com/Anonyfox/meteor-speedrun-ai-template myapp
cd myapp
meteor npm install
npm start

Open http://localhost:3000

Stack

Tech	Purpose
Meteor 3.x	Full-stack framework with reactivity
React 18	UI layer
TypeScript	Strict mode enabled
Bootstrap 5	Styling via react-bootstrap
Biome	Linting + formatting

Architecture

imports/
├── api/                    # Collections, methods, publications
└── ui/
    ├── components/
    │   ├── molecules/      # Small reusable pieces (atoms only)
    │   └── organisms/      # Page sections (NavBar, Footer, Hero)
    ├── hooks/              # Shared hooks (Pages only)
    └── pages/[feature]/
        ├── Index.tsx       # Smart container (hooks live here)
        └── templates/      # Pure layout components

Rule: Pages are smart (hooks, data fetching). Everything else is pure (props → JSX).

See docs/ATOMIC_DESIGN.md for full component guidelines.

Scripts

Command	Purpose
npm start	Dev server on localhost:3000
npm test	Full pipeline: types → lint → unit tests
npm run check	Format + lint with auto-fix
npm run test:code	Unit tests only (Mocha SSR)

Testing

Tests are colocated with components (Component.test.tsx). Pure components require tests; Pages don't.

Deployment

MVP (VPS):

cp .env.deploy.example .env.deploy   # Add server credentials
./scripts/deploy-mvp.sh              # Ships to Ubuntu server

Production: Meteor Galaxy for auto-scaling and managed infrastructure.

AI-Assisted Development

This template includes AGENTS.md — structured instructions for AI coding agents. It defines architecture rules, naming conventions, and dos/don'ts that tools like Cursor and Windsurf follow automatically.

---

Anonyfox • MIT • Ship fast or die configuring.