AT3 Stack Kit

The AI-native evolution of the T3 stack, built for edge deployment and serverless infrastructure

AT3 Stack (AIT3E: /eɪ aɪ tiː θriː iː/ AY-eye-TEE-three-EE, /eɪt θriː iː/ AYT-three-EE) revolutionizes full-stack development by combining the proven T3 stack with cutting-edge AI integration, edge-first architecture, and modern development tools.

Build production-ready applications with seamless AI provider integration, real-time streaming, and global edge deployment. The AT3 Stack ecosystem includes comprehensive tooling for scaffolding, migrating, and optimizing modern web applications.

Features

AI-First Integration Multi-provider AI support with OpenAI, Anthropic, and Google AI, featuring streaming responses and React hooks	Edge-First Architecture Built for Vercel Edge Functions and Cloudflare Workers with automatic global scaling and zero server management
Type-Safe Foundation Full TypeScript integration with Zod validation, comprehensive type generation, and strict configuration	Production Ready Comprehensive testing with Vitest and Playwright, PWA support, i18n, and deployment-ready configurations

Quick Start

Installation

# Clone the repository
git clone <repository-url>
cd at3-stack-kit

# Install dependencies with pnpm
pnpm install

# Set up environment variables
cp env.example .env.local

Basic Usage

# Initialize Supabase
npx supabase init
npx supabase start
npx supabase db push

# Start development server
pnpm dev

# Run with Turbopack (faster)
pnpm dev:turbo

That's it! Your AT3 application is ready at http://localhost:3000.

How It Works

1. T3 Foundation: Built on the proven Next.js + TypeScript + Tailwind foundation with App Router and React 19
2. AI Integration: Multi-provider AI client with streaming responses, React hooks, and comprehensive error handling
3. Edge Deployment: Optimized for Vercel Edge Functions and Cloudflare Workers with global CDN distribution
4. Type Safety: Full TypeScript integration with Zod validation and automatic type generation from Supabase

Supported Technologies

Frontend Next.js 15, React 19 TypeScript, Tailwind CSS 4	Backend Supabase PostgreSQL Edge Functions, Row Level Security
AI & Tools OpenAI, Anthropic, Google AI Biome, Vitest, Playwright	Deployment Vercel, Cloudflare Workers Docker, PWA Support

Core Commands

# Development
pnpm dev                         # Start development server
pnpm dev:turbo                   # Start with Turbopack (faster)
pnpm build                       # Build for production

# Code Quality
pnpm lint                        # Run Biome linter
pnpm lint:fix                    # Fix linting issues
pnpm format                      # Format code
pnpm type-check                  # TypeScript checking

# Testing
pnpm test                        # Run unit tests
pnpm test:e2e                    # Run E2E tests
pnpm test:coverage               # Run tests with coverage

# Database
pnpm db:generate                 # Generate types from Supabase
pnpm db:push                     # Push migrations
pnpm db:reset                    # Reset database

# Utilities
pnpm analyze                     # Analyze bundle size
pnpm clean                       # Clean build artifacts

Configuration

Environment Variables

# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# AI Providers
OPENAI_API_KEY=your_openai_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key
GOOGLE_AI_API_KEY=your_google_ai_api_key

# Authentication
NEXTAUTH_SECRET=your_nextauth_secret
NEXTAUTH_URL=http://localhost:3000

# Analytics (optional)
NEXT_PUBLIC_GA_ID=your_google_analytics_id
NEXT_PUBLIC_VERCEL_ANALYTICS=true

Key Features

• 🤖 AI Integration: Multi-provider support with streaming responses
• 🏗️ T3 Foundation: Next.js + TypeScript + Tailwind CSS
• 🗃️ Supabase Backend: PostgreSQL with auth and real-time features
• 🌍 Edge-First: Optimized for global deployment and scaling
• 🎨 Modern UI: Shadcn/ui components with Tailwind CSS v4
• 🔒 Authentication: Complete auth flow with social providers
• 🌐 Internationalization: Built-in i18n support with next-intl
• 📱 PWA Ready: Service worker and offline functionality
• 🧪 Testing: Comprehensive testing with Vitest and Playwright
• 📈 Performance: Bundle analysis and Core Web Vitals optimization

Examples

AI Chat Integration

import { useAICompletion } from '@/lib/ai/hooks';

export function ChatComponent() {
  const { completion, isLoading, generate } = useAICompletion({
    provider: 'openai',
    model: 'gpt-4-turbo',
  });

  return (
    <div>
      <button onClick={() => generate('Hello AI!')}>
        Send Message
      </button>
      {isLoading && <p>Thinking...</p>}
      {completion && <p>{completion}</p>}
    </div>
  );
}

Protected Route

import { requireAuth } from '@/lib/auth/auth-helpers';

export default async function DashboardPage() {
  const user = await requireAuth();

  return <div>Welcome {user.email}!</div>;
}

Database Integration

import { createServerClient } from '@/lib/supabase/server';

export async function getData() {
  const supabase = await createServerClient();
  
  const { data, error } = await supabase
    .from('posts')
    .select('*')
    .order('created_at', { ascending: false });

  return data;
}

Documentation

• Getting Started Guide - Complete setup instructions
• AT3 Stack Guide - Architecture and patterns
• API Reference - All commands and options
• Deployment Guide - Production deployment
• AI Integration - AI features and usage

Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit changes: git commit -m 'feat: add amazing feature'
4. Push to branch: git push origin feature/amazing-feature
5. Open a Pull Request

Commit Convention

We use Conventional Commits:

• feat: - New features
• fix: - Bug fixes
• docs: - Documentation updates
• style: - Code formatting
• refactor: - Code refactoring
• test: - Add tests
• chore: - Update dependencies

Roadmap

• Enhanced AI Models - Support for Claude 3 Opus and GPT-4 Vision
• Vector Database - Native vector embeddings with Supabase
• AI Agents Framework - Built-in agent orchestration patterns
• Advanced Analytics - Real-time usage metrics and AI cost tracking

Requirements

• Node.js: >= 22.0.0
• pnpm: >= 10.0.0 (recommended over npm/yarn)
• Git: Latest version
• Operating System: Windows, macOS, Linux

License

MIT License - see the LICENSE file for details.

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: support@entro314-labs.com
• Documentation: AT3 Stack Docs

---

Made with ❤️ by entro314-labs

Website • Documentation • Community • Twitter