Skip to content

Home

Jump to bottom
aiyu-ayaan edited this page Jul 13, 2026 · 9 revisions

Portfolio Website Wiki

Welcome to the comprehensive documentation for the Portfolio Website project! This wiki provides detailed information about the project's features, setup, configuration, and usage.

License: MIT Next.js React PostgreSQL Docker

📚 Quick Navigation

Getting Started

Features & Usage

Development

Deployment

Troubleshooting

🎯 What is this Project?

A modern, responsive, and fully customizable portfolio website built with Next.js 16, Tailwind CSS, and PostgreSQL (Prisma). This project showcases skills, detailed project case studies, blogs, and provides a way for visitors to contact you. It features a comprehensive Admin Panel for managing all content without touching code.

Perfect for: Developers, designers, freelancers, and tech professionals looking for a production-ready portfolio solution.

✨ Key Features

  • 🧠 AI Neural Core - Intelligent generative content & design synthesis

  • 🎨 52 Pre-built Themes with a live custom color/font editor

  • 🪄 AI Theme Architect - Generate design systems from a prompt

  • 📄 Resume Studio - LaTeX resume editor with Visual/Code modes, named versions, auto-compile, and one-click publish

  • 🌓 Classic vs V2 Site - Switch visitors between the original UI and the V2 editorial redesign, per default or side-by-side at /v1 and /v2

  • 🔌 MCP Server - Expose your portfolio's tools, resources, and prompts over the Model Context Protocol for AI clients

  • ✨ AI Hub Page - Manage the public /ai showcase (skills, recommendations, prompt library) from its own admin section

  • 🩺 Server Health Dashboard - Live CPU/memory/disk/event-loop metrics, uptime monitoring, and an AI log analyzer

  • 🗄️ Storage & Resources Manager - Reclaim disk space by purging orphaned uploads and batch-converting legacy images to WebP

  • 🚀 Hosted Apps Directory - Track and showcase your deployed apps/services alongside your projects

  • 🏷️ Configurable Section Stages - Pin Beta/Alpha badges to any admin section from Settings

  • 🔧 Complete Admin Panel - No code changes needed

  • ⏰ Task Scheduler - Visual cron builder & maintenance automation

  • 🔔 Unified Notifications - Discord, Telegram, and ntfy push integrations

  • 📺 AdSense Script Injector - Inline script preview & header management

  • 🔍 Global Search - Fast command palette (Ctrl+K)

  • 🖥️ Terminal Navigation - Interactive command-line interface

  • 📝 Blog System with Markdown support

  • 🖼️ Gallery Management with image optimization

  • 📊 GitHub Integration for repository stats

  • 🔒 Enterprise Security with Docker hardening

  • 📱 Fully Responsive design

  • ⚡ SEO Optimized with sitemap and meta tags

  • 🚀 Docker Ready for easy deployment

  • 📧 Contact Form with email & webhook dual-routing

🚀 Quick Start

# Clone the repository
git clone https://github.com/aiyu-ayaan/Aiyu.git
cd Aiyu

# Configure environment
cp .env.example .env
# Edit .env with your credentials

# Using Docker (Recommended)
npm run docker:build
npm run docker:up
npm run docker:verify

# 🚨 IMPORTANT: Seed database (FIRST TIME ONLY)
curl http://localhost:3000/api/seed

# Access at http://localhost:3000
# Admin Panel: http://localhost:3000/admin

⚠️ Critical First Step: After installation, you MUST visit http://localhost:3000/api/seed to populate the database with initial data. See Quick Start Guide for details.

📖 Documentation Structure

This wiki is organized into the following sections:

  1. Getting Started - Installation, configuration, and initial setup
  2. Features & Usage - Detailed feature documentation and usage guides
  3. Development - Technical documentation for developers
  4. Deployment - Production deployment and optimization
  5. Troubleshooting - Common issues and solutions

🤝 Getting Help

📝 Recent Updates

  • ✅ Added Resume Studio (/admin/resume) — LaTeX editor with Visual/Code toggle, drag-and-drop section cards, AI assistant, named versions, auto-compile/auto-save, and one-click publish
  • ✅ Added Classic vs V2 Site switch (/admin/version) — pick which redesign visitors land on by default; the other stays reachable at /v1 or /v2
  • ✅ Shipped the V2 site redesign — an editorial-depth alternative theme for landing, about, projects, gallery, contact, apps, and sitemap pages
  • ✅ Added the MCP Server admin section (/admin/mcp) — configure transports, capabilities, custom tools/resources/prompts, and a dedicated write-access bearer token
  • ✅ Added AI Hub admin section (/admin/ai-page) to manage the public /ai showcase page (skills, recommendations, prompt library, layout)
  • ✅ Added Server Health dashboard (/admin/health) — live resource meters, uptime monitoring, and an AI log analyzer
  • ✅ Added Resources manager (/admin/resources) for orphaned-upload cleanup and legacy image → WebP conversion
  • ✅ Added Apps section (/admin/apps) to manage a hosted apps/services directory
  • ✅ Added per-section Beta/Alpha stage badges configurable from Settings
  • ✅ Expanded theme presets to 52 built-in themes
  • ✅ Integrated AI Neural Core (Gemini Pro) for intelligent content generation
  • ✅ Added AI Theme Architect for generative design systems
  • ✅ Implemented AI-powered Project Synthesis (Names, Polish, Tech Stack)
  • ✅ Enhanced admin panel with contextual AI tools
  • ✅ Added global search feature (Ctrl+K)
  • ✅ Added interactive terminal navigation feature (Ctrl+`)
  • ✅ Enhanced Docker security with crypto miner prevention
  • ✅ Implemented blog automation API
  • ✅ Added GitHub statistics integration
  • ✅ Improved image optimization with HEIC support
  • ✅ Added comprehensive admin panel features
  • ✅ Implemented Task Scheduler & Cron Jobs module with visual builder and real-time expression translations
  • ✅ Implemented Unified Notification Dispatcher supporting Discord, Telegram, and ntfy push alerts
  • ✅ Redesigned Contact Settings Dashboard with n8n webhook and push dual-routing configuration
  • ✅ Integrated Google AdSense script dynamic injector with live dashboard status preview

🌟 Contributors

This project is maintained by Aiyu Ayaan and the open-source community.

Want to contribute? Open an issue or pull request on GitHub!

Last Updated: July 2026 • Version: 4.7.6 • License: MIT

Clone this wiki locally