Genome Catalog

Complete catalog of all official project genomes available in The Architech marketplace.

Understanding Our Genome Organization

We organize genomes into three categories to help you find the right starting point:

🚀 Starters (Complexity Progression)

Choose based on how much infrastructure you need. Start simple and scale up.

🎯 Use Cases (Domain-Specific)

Pre-configured for specific business needs (blog, SaaS, AI, Web3).

📚 Reference (Learning & Demos)

The ultimate showcase with ALL capabilities enabled.

🚀 STARTERS (Complexity Progression)

Start with the simplest foundation and scale up as needed.

01. Hello World

Aliases: hello-world, minimal
Complexity: ⚪ Minimal (3 modules)
Generation Time: ~60 seconds
No external dependencies

What You Get:

• Next.js 15 with App Router
• TypeScript (strict mode)
• Tailwind CSS v4
• Shadcn/ui components (button, card, input, label)
• Git initialization

Use Case: Learning The Architech, simple landing pages, prototypes

Generate:

architech new my-app --genome hello-world

Prerequisites: Node.js 18+ only (no database, no API keys)

02. Simple App

Aliases: simple-app, simple
Complexity: 🟢 Simple (5 modules)
Generation Time: ~2 minutes
Production-ready basics

What You Get:

• Next.js 15 + TypeScript
• Golden Core (Zustand, Vitest, ESLint, Prettier, Zod)
• Shadcn/ui components
• Git + Vercel deployment ready

Use Case: Marketing sites, portfolios, simple web apps

Generate:

architech new my-app --genome simple-app

Prerequisites: Node.js 18+ (no database required)

03. Standard App ⭐ RECOMMENDED

Aliases: standard-app, standard
Complexity: 🟡 Standard (10 modules)
Generation Time: ~5 minutes
The recommended foundation

What You Get:

• Next.js 15 + TypeScript
• Golden Core (Zustand, Vitest, ESLint, Prettier, Zod)
• Database (Drizzle ORM + PostgreSQL)
• Data Fetching (TanStack Query)
• Infrastructure Connectors (SSR hydration, forms)
• Shadcn/ui components
• Git + Vercel deployment

Use Case: Most production apps, SaaS foundations, web applications

Why Recommended:

• ✅ Perfect balance of features and simplicity
• ✅ Database-ready for real applications
• ✅ Type-safe data layer out of the box
• ✅ Easy to add features (auth, payments, etc.)

Generate:

architech new my-app --genome standard-app

Prerequisites:

• PostgreSQL database (recommend Neon (opens in a new tab) free tier)

04. Full Stack App

Aliases: full-stack-app, enterprise
Complexity: 🔴 Full-Featured (14 modules)
Generation Time: ~8 minutes
Enterprise-grade infrastructure

What You Get:

• Everything in Standard App
• + Monitoring (Sentry error tracking)
• + Docker (containerized deployment)
• + Internationalization (next-intl: en, fr, es, de)
• Enhanced infrastructure (devtools, advanced configs)

Use Case: Enterprise SaaS, complex applications, production at scale

Generate:

architech new my-app --genome full-stack-app

Prerequisites:

• PostgreSQL database
• Sentry DSN (optional, for monitoring)
• Docker (for containerized deployment)

🎯 USE CASES (Domain-Specific)

Pre-configured for specific business needs with all relevant features.

Blog Platform

Aliases: blog, blog-platform
Based on: Standard App + Content features
Modules: 12

What You Get:

• Standard App foundation
• Auth (Better Auth) for authors
• Email (Resend) for notifications
• Content management
• i18n (en, fr, es, de)
• SEO optimized

Use Case: Tech blogs, documentation sites, content publishers

Generate:

architech new my-blog --genome blog

Prerequisites: Database + Resend API key

SaaS Platform

Aliases: saas, saas-platform, full-saas
Based on: Full Stack App + All business features
Modules: 18+

What You Get:

• Full Stack App foundation
• Auth (Better Auth with email + OAuth)
• Payments (Stripe with subscriptions)
• Teams (Multi-tenant architecture)
• Email (Resend transactional emails)
• Monitoring (Sentry)
• Docker + Vercel deployment

Use Case: B2B SaaS, collaboration platforms, subscription products

Generate:

architech new my-saas --genome saas

Prerequisites:

• PostgreSQL database
• GitHub OAuth app
• Stripe account
• Resend API key

AI Application

Aliases: ai-app, ai-chat, ai-powered
Based on: Standard App + AI features
Modules: 13

What You Get:

• Standard App foundation
• AI Chat (Vercel AI SDK)
• Streaming responses
• Auth (Better Auth)
• Payments (Stripe for AI credits)
• Message persistence
• Beautiful chat UI

Use Case: ChatGPT alternatives, AI assistants, conversational interfaces

Generate:

architech new my-ai-app --genome ai-app

Prerequisites:

• PostgreSQL database
• OpenAI or Anthropic API key
• Stripe account (for AI credits)

Web3 DApp

Aliases: web3, dapp, blockchain
Based on: Standard App + Web3 features
Modules: 14

What You Get:

• Standard App foundation
• Wallet Connection (RainbowKit, WalletConnect)
• Smart Contracts (ethers.js integration)
• Blockchain Queries (wagmi + viem)
• Auth (Better Auth)
• Off-chain data (Drizzle)

Use Case: Decentralized apps, NFT marketplaces, blockchain tools

Generate:

architech new my-dapp --genome web3

Prerequisites:

• PostgreSQL database (off-chain data)
• Ethereum node/provider (Infura, Alchemy)
• Wallet for testing (MetaMask)

📚 REFERENCE (Learning & Demos)

Ultimate Showcase

Aliases: showcase, ultimate, demo
Complexity: 🔴 Comprehensive (20+ modules)
Generation Time: ~15 minutes
ALL capabilities enabled

What You Get:

• Everything: Auth + Payments + Teams + AI + Web3 + Email + Monitoring
• All adapters, connectors, features working together
• Complete test suite
• Full deployment setup (Vercel + Docker)

Use Case: Learning the system, reference implementation, demos

Generate:

architech new my-showcase --genome showcase

Prerequisites: All services (not recommended for production apps)

📋 Quick Comparison

🎯 Which Should You Choose?

I'm learning The Architech

→ Start with hello-world (60 seconds, zero dependencies)

I'm building a real app

→ Use standard-app ⭐ (recommended foundation with database)

I'm building specific functionality

→ Choose a Use Case:

• Content platform? → blog
• B2B product? → saas
• AI product? → ai-app
• Blockchain app? → web3

I need enterprise features

→ Use full-stack-app (monitoring, Docker, i18n)

I want to see everything

→ Use showcase (all features for learning)

🔍 Listing Genomes

Modern Blog / CMS

Aliases: blog, blog-starter
Complexity: Intermediate
Generation Time: ~5 minutes
Modules: 12

What You Get:

• Next.js 15 with MDX support
• Drizzle ORM (PostgreSQL)
• Better Auth (email/password)
• Resend email integration
• Next-Intl (i18n: en, fr, es, de)
• Zustand state management
• Sentry monitoring
• shadcn/ui components
• Vitest testing

Use Case: Tech blogs, documentation sites, content publishers

Generate:

architech new my-blog --genome blog

Prerequisites:

• PostgreSQL database (recommend Neon free tier)
• Resend API key (for emails)

Full SaaS Platform

Aliases: saas, saas-starter, full-saas
Complexity: Intermediate (feature-rich)
Generation Time: ~10 minutes
Modules: 15

What You Get:

• Next.js 15 with App Router
• Drizzle ORM (PostgreSQL with Neon)
• Better Auth (email + OAuth)
• Stripe payments & subscriptions
• Team management (multi-tenant)
• Email system (Resend)
• TanStack Query + Zustand
• shadcn/ui components
• Vitest + Playwright testing
• Sentry monitoring
• Docker + Vercel deployment

Use Case: B2B SaaS, productivity tools, collaboration platforms

Generate:

architech new my-saas --genome saas-starter

Prerequisites:

• PostgreSQL database
• GitHub OAuth app credentials
• Stripe account (test mode)
• Resend API key

AI-Powered Application

Aliases: ai-app, ai-chat, ai-powered
Complexity: Intermediate
Generation Time: ~8 minutes
Modules: 10

What You Get:

• Next.js 15 with streaming
• Vercel AI SDK
• Drizzle ORM (conversation history)
• TanStack Query
• AI chat interface (shadcn/ui)
• Streaming responses
• Zustand for chat state
• Vitest testing

Use Case: ChatGPT alternatives, AI assistants, conversational interfaces

Generate:

architech new my-ai-app --genome ai-app

Prerequisites:

• OpenAI or Anthropic API key
• PostgreSQL database (for conversation history)

🔴 Advanced Genomes (Full-Featured)

Web3 DApp

Aliases: web3, dapp, blockchain
Complexity: Advanced
Generation Time: ~12 minutes
Modules: 12

What You Get:

• Next.js 15
• Web3.js / ethers.js
• Wallet connectors (MetaMask, WalletConnect)
• Smart contract integration
• Drizzle ORM (off-chain data)
• shadcn/ui components
• Zustand for wallet state
• TanStack Query

Use Case: Decentralized apps, NFT marketplaces, blockchain tools

Generate:

architech new my-dapp --genome web3

Prerequisites:

• Ethereum node/provider (Infura, Alchemy)
• Wallet for testing (MetaMask)

Ultimate Showcase

Aliases: showcase, ultimate, demo
Complexity: Advanced
Generation Time: ~15 minutes
Modules: 20+

What You Get:

• Everything - All features enabled
• Auth + Payments + Teams + AI + Web3 + Email + Monitoring
• All adapters and connectors working together
• Complete test suite
• Full deployment setup

Use Case: Demonstrations, learning, reference implementation

Generate:

architech new my-showcase --genome showcase

Prerequisites: All services (PostgreSQL, Stripe, GitHub OAuth, OpenAI, etc.)

📋 Quick Comparison

🎯 Choosing the Right Genome

I want to learn The Architech

→ Start with hello-world (60 seconds, zero config)

I'm building a SaaS product

→ Use saas-starter (complete business features)

I'm building a content platform

→ Use blog (CMS, i18n, email)

I'm building an AI product

→ Use ai-app (chat, streaming, AI SDK)

I'm building a blockchain app

→ Use web3 (wallet integration, smart contracts)

I want to see everything

→ Use showcase (all features enabled)

🔍 Listing Genomes

# See all available genomes
architech list-genomes
 
# Filter by complexity
architech list-genomes --complexity simple
architech list-genomes --complexity intermediate
architech list-genomes --complexity advanced
 
# Search by keyword
architech list-genomes --search payment
architech list-genomes --search ai
architech list-genomes --search blockchain
 
# Verbose output (show file paths)
architech list-genomes --verbose

🛠️ Creating Custom Genomes

You can create your own genome files:

// my-custom.genome.ts
import { defineGenome } from '@thearchitech.xyz/marketplace/types';
 
export default defineGenome({
  version: '1.0.0',
  project: {
    name: 'my-custom-app',
    framework: 'nextjs',
    description: 'My custom application'
  },
  modules: [
    // Pick any adapters, connectors, and features
    { id: 'framework/nextjs', parameters: { typescript: true } },
    { id: 'database/drizzle', parameters: { provider: 'neon' } },
    // ... add more modules
  ]
});

Then use it:

architech new ./my-custom.genome.ts

Next: Modules Catalog → | Getting Started →