Skip to content

aifa-agi/aifa-v2.1

Repository files navigation

πŸš€ AI - SEO - Parallel - Intercepting - Routes - Nextjs - Starter

AIFA v2.1

Production‑ready template for advanced routing, parallel slots, and AI‑ready architecture.

Deploy with Vercel

GitHub Stars License Live Demo Next.js 15 TypeScript

🌐 Live Demo Β· πŸ“– Docs Β· πŸ’¬ Telegram


⭐ If you find this template useful, please give it a star! ⭐
It helps others discover the project and motivates further development.


🧩 What this template is for

AIFA v2.1 is a free, open‑source Next.js 15 starter focused on:

  • Parallel routes (@left, @rightStatic, @rightDynamic)
  • Intercepting routes for modals & mobile UX
  • SEO‑first static generation that works even without JavaScript
  • AI‑ready architecture (persistent chat slot, dynamic overlays)

This template is ideal for:

  • SaaS products combining static marketing pages with dynamic dashboards
  • Documentation sites enhanced with AI assistants
  • E‑commerce platforms with conversational search
  • Any project requiring independent UI streams and perfect SEO

✨ Key Features

  • βœ… Next.js 15 App Router with parallel & intercepting routes
  • βœ… SEO‑optimized static generation (SSG/ISR)
  • βœ… PWA‑ready (offline support, service worker)
  • βœ… TypeScript + Tailwind CSS
  • βœ… Zero‑config deployment to Vercel
  • βœ… Radix UI + Motion for animations
  • βœ… AI SDK integration ready (@ai-sdk/react, ai)
  • βœ… Content‑driven navigation via centralized config

πŸš€ Quick Start

1️⃣ Deploy to Vercel (fastest)

Click the button above to deploy this template to Vercel in one click.

2️⃣ Clone and run locally

git clone https://github.com/aifa-agi/aifa-v2.1.git cd aifa-v2.1 pnpm install pnpm dev

Open http://localhost:3000 in your browser.
!!! Use only Incognito Mode
!!! Use only Incognito Mode
!!! Use only Incognito Mode

πŸ“¦ Tech Stack

Category Tools
Framework Next.js 15 (App Router)
Language TypeScript 5
Styling Tailwind CSS 4
UI Components Radix UI, Lucide Icons
Animation Motion (Framer Motion successor)
AI Vercel AI SDK (ai, @ai-sdk/react)
Deployment Vercel
PWA next-pwa
Analytics Vercel Analytics

🧠 Core Architecture

Three Parallel Slots

app/ layout.tsx # Root with @left, @rightStatic, @rightDynamic @left/ # AI chat / auth / assistant @rightStatic/ # Static SEO pages (docs, features) @rightDynamic/ # Dynamic overlays (dashboards, admin)

  • @left: Persistent AI assistant (desktop) or modal (mobile)
  • @rightStatic: Pure server components, static HTML, works without JS
  • @rightDynamic: Conditional overlay for authenticated/advanced flows

This separation allows SEO‑perfect static pages and AI‑driven UX to coexist without compromise.


πŸ“ Project Structure

aifa-v2.1/
β”œβ”€β”€ app/
β”‚ β”œβ”€β”€ layout.tsx # Root parallel layout
β”‚ β”œβ”€β”€ @left/ # Left slot (chat, auth)
β”‚ β”œβ”€β”€ @rightStatic/ # Static content slot
β”‚ β”‚ β”œβ”€β”€ (_PUBLIC)/
β”‚ β”‚ β”‚ β”œβ”€β”€ features/
β”‚ β”‚ β”‚ └── docs/
β”‚ β”‚ └── @modal/ # Intercepting routes
β”‚ └── @rightDynamic/ # Dynamic overlay
β”œβ”€β”€ components/
β”‚ β”œβ”€β”€ seo-page-wrapper/ # SEO wrappers
β”‚ β”œβ”€β”€ code-block/ # Syntax highlighting
β”‚ └── ui/ # Radix + custom components
β”œβ”€β”€ config/
β”‚ β”œβ”€β”€ app-config.ts # Global settings
β”‚ └── content/
β”‚ └── content-data.ts # Navigation metadata
β”œβ”€β”€ lib/
β”‚ └── construct-metadata.ts # SEO helper
└── public/
└── images/ # Assets

🎨 Key Components

πŸ”§ Configuration Environment Variables

# Site Configuration
NEXT_PUBLIC_SITE_URL=https://aifa-v2-1.vercel.app
NEXT_PUBLIC_APP_NAME=AI SEO Next.js Starter with Advanced App Router
NEXT_PUBLIC_APP_SHORT_NAME=AIFA
NEXT_PUBLIC_APP_DESCRIPTION=Production-ready template combining AI chat capabilities with comprehensive advanced routing tutorial. Built with focus on maximum SEO optimization, PWA functionality, and hybrid rendering (Static + Dynamic generation) with role-based access control.
NEXT_PUBLIC_MAIL_SUPPORT=bolshiyanov@gmail.com
NEXT_PUBLIC_CHAT_BRAND=ChatGPT

# Localization
NEXT_PUBLIC_DEFAULT_LOCALE=en

# Social Media Links
NEXT_PUBLIC_TWITTER_HANDLE=@aifa_agi
NEXT_PUBLIC_GITHUB_URL=https://github.com/aifa-agi/aifa-v2.1
NEXT_PUBLIC_LINKEDIN_URL=https://linkedin.com/bolshiyanov
NEXT_PUBLIC_FACEBOOK_URL=

# PWA Configuration
NEXT_PUBLIC_PWA_THEME_COLOR=#ffffff
NEXT_PUBLIC_PWA_BACKGROUND_COLOR=#ffffff
NEXT_PUBLIC_PWA_SCREENSHOT_MOBILE=
NEXT_PUBLIC_PWA_SCREENSHOT_DESKTOP=

NEXT_PUBLICTHEME_COLORS_LIGHT=#ffffff
NEXT_PUBLIC_THEME_COLORS_DARK=#09090b

# SEO Configuration
NEXT_PUBLIC_SEO_INDEXING=allow
NEXT_PUBLIC_ROBOTS_INDEX=true
NEXT_PUBLIC_ROBOTS_FOLLOW=true

# OpenGraph Configuration
NEXT_PUBLIC_OG_LOCALE=en_US
NEXT_PUBLIC_OG_IMAGE_WIDTH=1200
NEXT_PUBLIC_OG_IMAGE_HEIGHT=630
NEXT_PUBLIC_OG_TYPE=website

# Content Type Defaults (for different sections)
NEXT_PUBLIC_BLOG_CONTENT_TYPE=blog
NEXT_PUBLIC_PRODUCT_CONTENT_TYPE=product
NEXT_PUBLIC_DOC_CONTENT_TYPE=documentation

# Author Configuration
NEXT_PUBLIC_DEFAULT_AUTHOR_NAME=bolshiyanov
NEXT_PUBLIC_DEFAULT_AUTHOR_EMAIL=bolshiyanov@agmail.com
NEXT_PUBLIC_DEFAULT_AUTHOR_TWITTER=aifa_agi
NEXT_PUBLIC_DEFAULT_AUTHOR_LINKEDIN=aifa
NEXT_PUBLIC_DEFAULT_AUTHOR_FACEBOOK=
NEXT_PUBLIC_DEFAULT_AUTHOR_BIO=Building the future of AI applications
NEXT_PUBLIC_DEFAULT_AUTHOR_IMAGE=/app-images/app-config-images/author-avatar.png
NEXT_PUBLIC_DEFAULT_AUTHOR_URL=https://aifa.dev
NEXT_PUBLIC_DEFAULT_AUTHOR_JOB_TITLE=AI Developer

# Search Engine Verification
NEXT_PUBLIC_GOOGLE_VERIFICATION=
NEXT_PUBLIC_YANDEX_VERIFICATION=

NEXT_PUBLIC_GOOGLE_ANALYTICS_ID=

# Mobile App Configuration
NEXT_PUBLIC_IOS_APP_ID=
NEXT_PUBLIC_ANDROID_PACKAGE=

# Environment
NEXT_PUBLIC_ENVIRONMENT=production

πŸ“š Documentation

Full documentation and live examples available on our website.

Static Generation
Lightning-Fast SEO Pages
Parallel Routing
Independent UI Flows
Dynamic Generation
On-Demand Rendering

🀝 Contributing

We welcome contributions from the community! Here's how you can help:

Contributors Issues Pull Requests

Ways to Contribute

  • πŸ› Report bugs β€” Open an issue with reproduction steps
  • πŸ’‘ Suggest features β€” Share your ideas for improvements
  • πŸ“ Improve docs β€” Help us make the README better
  • πŸ”§ Submit PRs β€” Fix bugs or add features
  • ⭐ Star the repo β€” Show your support!

Get Started



# Fork the repo

# Clone your fork

git clone https://github.com/YOUR_USERNAME/aifa-v2.1.git
cd aifa-v2.1

# Create a branch

git checkout -b feature/amazing-feature

# Make your changes

pnpm install
pnpm dev

# Commit and push

git add .
git commit -m "Add amazing feature"
git push origin feature/amazing-feature

# Open a PR!


πŸ“ License

License: AGPL v3

This project is licensed under the GNU Affero General Public License v3.0.

See LICENSE for full details.


🌐 Links & Community

Official Resources

Website Live Demo GitHub

Connect with the Author

Telegram LinkedIn Email


πŸ’« Deploy Your Own

Click the button below to deploy your own instance of AIFA v2.1 to Vercel:

Deploy with Vercel

⭐ Star History

Star History Chart

🎯 If this template helped you, please consider:

GitHub Stars

⭐ Star this repository β€” It helps others discover the project!


Built with ❀️ by the AIFA team

Β© 2025 AIFA Β· Next.js 15 Β· App Router Β· AI-Ready Architecture