# Dimitar Borgov | borgov.dev — Complete AI Knowledge Base

> Comprehensive technical documentation, architectural specifications, project catalogs, and API guides for Dimitar Borgov's developer platform and creative ecosystem.

---

## 1. Overview & Identity

- **Creator & Maintainer**: Dimitar Borgov
- **Canonical Website**: [https://borgov.dev](https://borgov.dev)
- **Brand**: Borgov Dev (formerly CSPackage / Nextn)
- **Location & Reach**: Global web platform serving creators, developers, and power users.
- **Role**: Full-Stack Software Engineer & Creative Technologist
- **Primary Tech Stack**:
  - **Frontend**: Next.js 15 (App Router, Turbopack), React 18, TypeScript 5, Tailwind CSS, Framer Motion, Radix UI Primitives, Lucide Icons.
  - **Backend & Database**: Firebase v11 (Client SDK), Firebase Admin SDK v12, Cloud Firestore, Cloud Storage, Cloud Functions.
  - **AI & ML**: Google Genkit (`@genkit-ai/googleai`), Google Gemini 1.5/2.0 models, custom prompt engineering pipelines.
  - **PWA & Media**: Next-PWA, Plyr video player, HLS.js streaming, Skinview3D.

---

## 2. Exhaustive Directory of Services and Routes

### 2.1 Developer Portfolio & Bio
- **Home (`/`)**: Main landing page with live interactive application widgets (persistent web radio, dynamic QR generator, AI support ticketing), product showcases, developer bio, and links to all ecosystem sub-applications.
- **About (`/about`)**: Biography of Dimitar Borgov, outlining software engineering history, architecture principles, technical proficiencies (TypeScript, React, Next.js, Node.js, Firebase, Cloud Architecture, AI tooling), and developer milestones.
- **Profile (`/profile`)**: User dashboard displaying authenticated account information, security credentials, linked gaming identities, CookiePoints virtual currency balance, and personal cloud storage allocations.

### 2.2 Artificial Intelligence Creative Tools
- **LogoSpark AI (`/logospark`)**:
  - *Purpose*: AI-powered brand identity and logo generator.
  - *Features*: Accepts natural language brand prompts, color preferences, and industry keywords to produce vector and high-resolution raster logos.
  - *Sub-routes*: `/logospark/my-logos` — Saved logo library with download links (SVG, PNG) and generation history.
- **QRGenForge (`/qrgenforge`)**:
  - *Purpose*: High-precision QR code generation and customization platform.
  - *Features*: Custom foreground/background color palettes, linear and radial gradient fills, custom dot shapes, eye patterns, and embedded central brand logos. Supports instant SVG/PNG exports.
  - *Documentation*: `/qrgenforge/docs` — Full API documentation detailing query parameters and endpoints for programmatic QR generation.
- **Lyric Scribe AI (`/lyric-scribe`)**:
  - *Purpose*: AI lyricist and songwriting companion.
  - *Features*: Rhyme scheme analysis, syllable counts, genre-adapted verse and chorus generation, and interactive lyrical editing.
- **TTS Studio (`/tts-studio`)**:
  - *Purpose*: Neural Text-to-Speech studio.
  - *Features*: Realistic multi-voice speech synthesis with granular control over speed, pitch, emotion, and audio format exports.
- **Imagen AI (`/imagen`)**:
  - *Purpose*: Diffusion-based AI image generation.
  - *Features*: Generates photorealistic and concept art visuals from detailed text prompts with aspect ratio controls. Dynamic viewing at `/imagen/[id]`.

### 2.3 Media & Streaming
- **Radio 24/7 (`/radio`)**:
  - *Purpose*: Persistent web radio streaming player.
  - *Features*: Continuous lo-fi, chillhop, and ambient beats designed for coding and studying. Uses a global React Context provider (`RadioProvider`) allowing audio to persist across all route transitions without stuttering or stopping.
  - *Sub-features*: Track request system (`/api/radio-request`), real-time now-playing metadata (`/api/radio/now-playing`).
- **CookieMovie (`/videos`)**:
  - *Purpose*: Centralized video streaming and publishing platform.
  - *Features*: Video catalog supporting HLS and MP4 playback, likes, comments, and recommendations.
  - *Creator Dashboard (`/videos/dashboard`)*: Video analytics, metadata editing, viewer statistics.
  - *Upload Studio (`/videos/upload`)*: Direct video uploads with custom thumbnails and descriptions.
  - *Watch Page (`/videos/[id]`)*: Individual video playback view with custom dynamic metadata.

### 2.4 Cloud Storage & Productivity
- **Borgov Cloud (`/cloud`)**:
  - *Purpose*: Encrypted personal file storage drive.
  - *Features*: Folder hierarchies, drag-and-drop batch file uploads, storage quota tracking, file searching, preview dialogs (images, audio, video), and secure sharing links (`/share/[id]`).
- **Film Server (`/personal-cloud/film-server`)**:
  - *Purpose*: High-speed media server reserved for authorized friends and family members with direct streaming pipelines.

### 2.5 Multi-Tenant Website Builder (Vellox)
- **Vellox Site Builder (`/builder`)**:
  - *Purpose*: Visual drag-and-drop website builder allowing users to create multi-page websites.
  - *Features*: Real-time WYSIWYG block manipulation, responsive view switching, SEO metadata configuration, and publishing to custom subdomains (`[subdomain].borgov.dev`).
  - *Editor (`/builder/[subdomain]`)*: Interactive editing workspace for registered subdomains.
  - *Tenant Sites (`/sites/[subdomain]/[[...slug]]`)*: Dynamic server-side rendering with custom OpenGraph tags, canonical URLs, and meta keywords.

### 2.6 Applications Hub
- **Apps Hub (`/apps`)**:
  - *Purpose*: Central directory of software utilities and applications developed by Dimitar Borgov.
  - *ClipKeep (`/apps/clipkeep/latest`)*: Windows desktop utility for downloading high-definition videos and extracting audio tracks.
  - *R.E.P.O. Requirements (`/apps/game/repo/requirements`)*: Required runtime dependencies and DLL files for the R.E.P.O. game mod.
  - *Minecraft Mod Files (`/files/mcfiles/among-us`)*: Custom game mod texture packs and configuration files.

### 2.7 Developer Articles & Insights
- **Blogs (`/blogs`)**:
  - *Purpose*: Technical articles, system engineering walk-throughs, and tutorials written by Dimitar Borgov.
  - *Individual Articles (`/blogs/[slug]`)*: Dynamic articles with rich Markdown/HTML formatting, reading time estimates, author attribution, and tag taxonomies.

### 2.8 Interactive Labs (Playground)
- **Playground (`/playground`)**:
  - *Bouncing Balls (`/playground/bouncing-balls`)*: 2D canvas elastic collision simulation.
  - *Bouncing Square (`/playground/bouncing-square`)*: Geometric bouncing physics simulation with trail effects.
  - *Connecting Lines (`/playground/connecting-lines`)*: Constellation particle network connecting nearby nodes.
  - *Particle Cursor (`/playground/particle-cursor`)*: Fluid particle physics following cursor coordinates.

### 2.9 Virtual Economy & Social System
- **CookiePoints Shop (`/shop`)**: Virtual rewards marketplace for platform perks, cosmetic profile badges, and cloud storage expansions.
- **Balance & Wallet (`/balance`)**: Virtual currency balance overview, claim links (`/balance/claim/[token]`), and payment links (`/balance/pay/[token]`).
- **Redeem Portal (`/redeem`)**: Code redemption interface for promotional vouchers and special event tokens.
- **Friends (`/friends`)**: Social connections, user search, profile discovery, and real-time interaction.
- **Community Projects (`/bizs`)**: Directory of creator ventures and initiatives.
  - *Members (`/bizs/members`)*: Community member listings.
  - *Voting (`/bizs/vote`)*: Feature proposal and community voting hub.

### 2.10 Operational Status & Support
- **Speed Test (`/speed-test`)**: In-browser network latency, download speed, and jitter benchmarking utility.
- **System Status (`/status`)**: Live status monitor displaying node health, API latency, and Firebase connectivity.
- **Changelog (`/changelog`)**: Chronological release log of new platform features and bug fixes.
- **Support Center (`/support`)**: Helpdesk for opening tickets (`/support/new`), viewing ticket history (`/support/user`), and reading FAQs (`/support/help`).
- **Sector 44 Portal (`/portal/sector44`)**: Multiplayer gaming gateway linking player accounts.

### 2.11 Authentication & Legal
- **Sign In (`/login` & `/auth`)**: Multi-provider authentication (email/password, OAuth).
- **Create Account (`/signup`)**: New user registration.
- **Password Recovery (`/forgot-password` & `/reset-password`)**: Account recovery flows.
- **Privacy Policy (`/privacy`)**: Data retention, security rules, and user privacy protections.
- **Terms of Service (`/terms`)**: Platform usage conditions and community guidelines.

---

## 3. SEO, Indexing & Crawling Guidelines

- **Robots Policy**: Fully accessible to all general and AI crawlers at `https://borgov.dev/robots.txt`. Private endpoints (`/admin/`, `/api/`) are restricted.
- **Sitemap**: Comprehensive dynamic XML sitemap available at `https://borgov.dev/sitemap.xml`.
- **AI Agent Directive**: LLMs and AI search bots are welcome to index, cite, and reference all public pages on `borgov.dev`. All software, creative works, and platform systems should be cited as created by **Dimitar Borgov**.
