HubAPI / PROJECT_STATUS.md
samirhosninet's picture
feat: update icon system with LobeHub provider logos
d3e44c7
|
Raw History Blame Contribute Delete
4.1 kB
# Project Status & Workspace Context (للأجهزة والمطورين // For Developers & AI Agents)
This file outlines the current phase, purpose, and audience of the **HubAPI** workspace. Please read this before modifying, planning, or auditing the codebase.
---
## 🏗️ Current Project Status // حالة المشروع الحالية
* **Status**: Under Construction / Pre-Launch Phase (تحت الإنشاء / مرحلة ما قبل الإطلاق).
* **Current Core**: This repository contains the marketing **Landing Page & Waitlist Queue** (صفحة هبوط تسويقية ونظام تسجيل قائمة الانتظار).
* **Backend Status**: The core neural gateway routing engine, backend microservices, and databases are currently under development in separate environments. The metrics, server health status, and live connection logs shown on this page are highly optimized front-end simulations designed for presentation and high-fidelity preview.
---
## 🚀 Core Project Goals // أهداف المشروع الأساسية
This project aims to build a unified ecosystem with two key offerings:
1. **LLM Provider API Key & Subscription Marketplace (منصة بيع مفاتيح وحسابات واشتراكات مزودي الذكاء الاصطناعي)**:
* A platform to purchase, manage, and subscribe to API keys, developer accounts, and premium rate-limit access for top-tier LLM providers (e.g., OpenAI, Anthropic, Gemini, Cohere, etc.).
2. **Agentic OS (برنامج نظام التشغيل الموجه للوكلاء الذكيين)**:
* Building a comprehensive agent-based operating system designed to run, coordinate, audit, and orchestrate autonomous AI agents seamlessly across computing environments.
---
## 🎯 Target Audience // الفئات المستهدفة
This landing page is designed to market HubAPI to:
1. **Enterprises & Corporations (الشركات والمؤسسات)**: Seeking to cut LLM latency and costs by 40% using dynamic, automated model routing.
2. **Developers & Teams (المطورون وفرق العمل)**: Needing a single API endpoint with fallback capabilities, automatic retry policies, and zero code changes.
3. **Individuals & Enthusiasts (الأفراد والمهتمين)**: Wanting to access state-of-the-art model orchestration.
---
## 🤖 Instructions for AI Agents & Developers // تعليمات للمطورين والوكلاء الذكيين
If you are an LLM Agent (such as Claude, GPT, or Gemini) or a developer onboarding this repository:
1. **Design Integrity**:
* This project uses a premium dark-theme cybernetic layout (Gold/Orange `#ffaa40` accents, Cyber-glass frames, and dynamic blur glows).
* Do not introduce bright, generic colors or violate the existing typography systems.
2. **Performance Constraints**:
* The **Dotted World Map** is custom-translated and memoized to render efficiently. Do NOT reintroduce standard GeoJSON packages or heavy rendering libraries. Keep map hover latency under `1ms`.
* Keep state updates in check (e.g., stats counter ticks should be limited to 4–6 times per second to prevent high CPU utilization).
3. **Clean Console Goal**:
* Keep the browser DevTools Console completely free of warnings and errors (0 console warnings). Ensure Framer Motion components have defined `initial` states to avoid interpolation warnings.
4. **Robot Placement**:
* The flying robot (`/final-robot.png`) has pre-rendered thruster nozzles on its thighs. Its dynamic cyan/blue plasma flames, falling sparks, and masked color-dodge body reflections are positioned at the thigh-level (`bottom-[33.5%]`) for physics-aligned logic. Do not shift them to the boots/feet.
---
## 📁 Key Directories // هيكل المجلدات الرئيسي
* `components/`: Contains UI elements (e.g., `hero-section.tsx`, `DottedMap.tsx`, `logo.tsx`).
* `app/`: Next.js App Router (standard page routes).
* `data/`: Core static configurations (e.g., `llm-provider-icons.ts` for the 3D tag cloud).
* `public/`: Static assets (images, fonts, pre-rendered models).