pantaleone.net：基于 Next.js 16 的 AI 产品与数字解决方案平台

pantaleone.net - AI Portfolio & Digital Solutions

A modern, AI-focused portfolio and digital solutions platform built with Next.js 16 (App Router), Tailwind CSS v4, and Shadcn UI. Showcases AI products, automation workflows, and digital consulting services through an integrated shop, blog, and project showcase.

🛠️ Tech Stack

Built with cutting-edge web technologies and AI integrations for optimal performance and modern development experience.

Category	Technology	Description
Framework	Next.js 16	App Router, Turbopack, Server Components
Styling	Tailwind CSS v4	Utility-first CSS framework
UI Library	shadcn/ui	Accessible & customizable components
Animation	Motion	Declarative animations (formerly Framer Motion)
Content	Fumadocs	MDX-based content management
State	Nuqs & Jotai	URL state & atomic state management
AI Integration	Model Context Protocol	AI agent communication and tool integration
Analytics	PostHog	Product analytics & insights
Commerce	Stripe	Payment processing for AI products
Deployment	Vercel	Edge network deployment

✨ Key Features

🛒 AI Product Shop: E-commerce platform for selling AI apps, workflows, services, and artwork.
🤖 AI Agent Integration: LLM-txt endpoints for AI agent discovery and MCP protocol support.
📝 MDX Blog: Comprehensive content on AI, automation, and digital transformation.
🎨 Modern Aesthetic: Minimalist design with interactive particle animations and smooth transitions.
🌗 Dark Mode: Seamless theme switching with system preference detection.
⚡ High Performance: Optimized Core Web Vitals, fast LCP/FCP using Next.js 16.
🔎 Smart Search: Client-side fuzzy search with keyword highlighting across all content.
📱 Responsive: Fluid layouts that adapt perfectly to mobile, tablet, and desktop.
🔍 SEO Ready: JSON-LD schema, dynamic sitemap, robots.txt, and Open Graph tags.
💳 Payment Integration: Stripe-powered checkout for AI products and services.
📊 Analytics: PostHog integration for user behavior insights and conversion tracking.

🚀 Getting Started

Follow these steps to run the project locally.

Prerequisites

Node.js 20+ installed
npm or pnpm (recommended)

Installation

Clone the repository

git clone https://github.com/pantaleone-ai/pnet-2026-main.git
cd pnet-2026-main

Install dependencies
```
npm install
# or
pnpm install
```
Configure Environment

Copy the template to create your local environment file:
```
cp env.template .env.local
```
Open .env.local and add your API keys (e.g., Stripe, PostHog, Resend).
Start the Development Server
```
npm run dev
```
The site should be live at http://localhost:1408 (development port).

Available Scripts

Command	Description
`npm run dev`	Starts the development server with Turbopack
`npm run build`	Builds the application for production
`npm run start`	Starts the production server
`npm run lint`	Runs ESLint checks
`npm run format:write`	Formats code using Prettier
`npm run validate-seo`	Validates SEO configuration

🏗️ Project Structure

A comprehensive overview of the project architecture:

pantaleone.net/
├── actions/           # Server actions for data mutations and API calls
├── app/               # Next.js App Router (pages, layouts, API routes)
│   ├── (app)/         # Main application routes
│   ├── (llms)/        # AI agent discovery endpoints (/llms.txt, /llms-full.txt)
│   └── api/           # REST API endpoints
├── components/        # Shared React components (atomic design)
├── config/            # Static configuration (site, navigation, SEO, analytics)
├── features/          # Feature-based modules
│   ├── blog/          # MDX blog system with search and categories
│   ├── shop/          # E-commerce platform for AI products
│   ├── projects/      # Portfolio project showcase
│   ├── home/          # Landing page components
│   └── common/        # Shared feature components
├── hooks/             # Custom React hooks
├── lib/               # Shared utilities and helpers
│   ├── mcp-utils.ts   # Model Context Protocol utilities
│   └── search-*.ts    # Search and indexing functionality
├── public/            # Static assets (images, fonts, favicons)
├── scripts/           # Build and utility scripts
├── styles/            # Global styles and Tailwind configuration
└── types/             # TypeScript type definitions

🤖 AI Agent Discovery

This platform includes LLM-txt endpoints for AI agent integration:

/llms.txt - Basic AI agent discovery information
/llms-full.txt - Comprehensive site information for AI agents
MCP Integration - Model Context Protocol support for advanced AI tool integration

These endpoints allow AI agents to discover and interact with the platform's content, products, and services programmatically.

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

Special thanks HireTim for the awesome base template! to the open-source community and the creators of these tools:

Fumadocs for the amazing documentation framework.
shadcn/ui for the beautiful component primitives.
Lucide for the crisp icon set.