feat: consolidate docs and blogs into web monorepo (#2)

* HAL-87: scaffold Vectorless docs site (Fumadocs)

Brand-matched Fumadocs (Next.js App Router) documentation site for
docs.vectorless.store.

- Dark theme primary; Geist Sans + Geist Mono + Instrument Serif display
- Blue->pink brand gradient and subtle grid background texture
- Branded landing page (hero, feature grid, quickstart strip)
- Sections: Getting Started, Core Concepts (tree retrieval, no-chunking,
  treewalk, citations), API Reference (placeholder), SDKs (TS/Python/Go),
  Self-hosting (Neon + R2 + QStash + Docker, placeholder)
- Orama search, OG images, llms.txt
- Uses canonical 'treewalk' strategy name (retired 'pageindex')

* Redesign docs site to the LIGHT Vectorless brand (HAL-190)

The Fumadocs site was wrongly built dark-first with a full-page grid
wash and aura/glow pseudo-elements. Restyle it to match the brand
visual identity in vectorless-why/DESIGN.md, which is LIGHT.

- Default theme -> light (RootProvider defaultTheme: 'light').
- Light is now the primary, clean canvas: #FCFCFD, ink #0A0A0A,
  secondary #3F3F46, muted #71717A, hairlines #E5E7EB.
- Remove the heavy body::before grid wash and body::after aura glow.
  Content/docs pages are clean near-white with whitespace.
- Reintroduce only a very faint brand grid rgba(20,86,240,0.06) on the
  landing hero, masked to fade out (.vl-hero-grid).
- Keep the blue->pink signal gradient on exactly one hero line; drop the
  second serif/gradient register on the pull quote (now plain light sans
  with a mono eyebrow caption).
- Mono eyebrows at 0.16em tracking; body weight ~300 per DESIGN.md.
- Quickstart block is now a real dark inset terminal (#0A0A0A) — the one
  place dark is allowed.
- Dark theme retained as an optional toggle, not the default.

Restyle only: nav, sidebar, search, section structure and content
unchanged. pnpm build passes.

* Redesign docs site to the LIGHT Vectorless brand (HAL-190) (#1)

The Fumadocs site was wrongly built dark-first with a full-page grid
wash and aura/glow pseudo-elements. Restyle it to match the brand
visual identity in vectorless-why/DESIGN.md, which is LIGHT.

- Default theme -> light (RootProvider defaultTheme: 'light').
- Light is now the primary, clean canvas: #FCFCFD, ink #0A0A0A,
  secondary #3F3F46, muted #71717A, hairlines #E5E7EB.
- Remove the heavy body::before grid wash and body::after aura glow.
  Content/docs pages are clean near-white with whitespace.
- Reintroduce only a very faint brand grid rgba(20,86,240,0.06) on the
  landing hero, masked to fade out (.vl-hero-grid).
- Keep the blue->pink signal gradient on exactly one hero line; drop the
  second serif/gradient register on the pull quote (now plain light sans
  with a mono eyebrow caption).
- Mono eyebrows at 0.16em tracking; body weight ~300 per DESIGN.md.
- Quickstart block is now a real dark inset terminal (#0A0A0A) — the one
  place dark is allowed.
- Dark theme retained as an optional toggle, not the default.

Restyle only: nav, sidebar, search, section structure and content
unchanged. pnpm build passes.

* docs: use the real Vectorless V logo in nav + favicon (HAL-191)

Replace the invented node-graph mark with the canonical logo — blue tile +
white V (M4 4 L12 20 L20 4) + pink focal dot — matching vectorless-dashboard's
icon.tsx; add the matching app favicon. Wordmark in Geist medium.

Closes HAL-191.

* docs: use the real Vectorless V logo in nav + favicon (HAL-191) (#2)

Replace the invented node-graph mark with the canonical logo — blue tile +
white V (M4 4 L12 20 L20 4) + pink focal dot — matching vectorless-dashboard's
icon.tsx; add the matching app favicon. Wordmark in Geist medium.

Closes HAL-191.

* Polish docs home page design

Elevate the marketing/home surface within the Vectorless light brand:
- Hero: real V mark, staggered precision reveal, refined terminal inset
- New document -> tree -> cited answer SVG motif (hairline, blue path, single pink citation dot; edges draw + nodes snap)
- Feature grid with mono index numbers and hover accent
- Parse/Walk/Cite three-step band
- Refined Instrument-Serif thesis closer with CTA

No new gradients, no dark page bg, no new mark - honors DESIGN.md.

* feat(docs): premium landing page redesign with GSAP and HeroShader

* style(docs): mintlify-inspired redesign and hero button fix

* chore(docs): redirect primary GitHub links to vectorless-engine

* fix(docs): resolve hero stacking and button visibility issues

* style(docs): fix code block contrast and remove card blue border

* chore: remove deprecated packages ts-sdk, openapi, and mcp-tools

* feat: migrate docs and blogs to monorepo and update branding

* style: premium editorial layout redesign for vectorless blog

* style: expand layout to full-width page

* ci: update workflows to match monorepo package configuration

* fix: resolve workspace react type conflicts by overriding react and react types

* chore: add typecheck scripts for all monorepo apps to run under turborepo

* fix: resolve lint errors and warnings across workspace packages

Author: hallelx2

.github/workflows/ci.yml

@@ -8,7 +8,7 @@ on:
 
 jobs:
   lint-and-typecheck:
-    name: Lint & Typecheck (TypeScript)
+    name: Lint & Typecheck
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -18,25 +18,8 @@ jobs:
           node-version: 20
           cache: pnpm
       - run: pnpm install --frozen-lockfile
-      - run: pnpm --filter=@vectorless/shared build
-      - run: pnpm --filter=vectorless typecheck
-      - run: pnpm --filter=@vectorless/web lint
-
-  test-ts-sdk:
-    name: Test TypeScript SDK
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm --filter=@vectorless/shared build
-      - run: pnpm --filter=vectorless build
-      - name: Run unit tests (skip integration)
-        run: cd packages/ts-sdk && npx vitest run __tests__/client.test.ts
+      - run: pnpm typecheck
+      - run: pnpm lint
 
   test-python-sdk:
     name: Test Python SDK
@@ -69,5 +52,4 @@ jobs:
           node-version: 20
           cache: pnpm
       - run: pnpm install --frozen-lockfile
-      - run: pnpm --filter=@vectorless/shared build
-      - run: pnpm --filter=vectorless build
+      - run: pnpm build

.github/workflows/publish-ts-sdk.yml

@@ -0,0 +1,9 @@
+# GEMINI_API_KEY: Required for Gemini AI API calls.
+# AI Studio automatically injects this at runtime from user secrets.
+# Users configure this via the Secrets panel in the AI Studio UI.
+GEMINI_API_KEY="MY_GEMINI_API_KEY"
+
+# APP_URL: The URL where this applet is hosted.
+# AI Studio automatically injects this at runtime with the Cloud Run service URL.
+# Used for self-referential links, OAuth callbacks, and API endpoints.
+APP_URL="MY_APP_URL"

apps/blogs/.env.example

@@ -0,0 +1,3 @@
+{
+  "extends": "next"
+}

apps/blogs/.eslintrc.json

@@ -0,0 +1 @@
+.vercel

apps/blogs/.gitignore

@@ -0,0 +1,20 @@
+<div align="center">
+<img width="1200" height="475" alt="GHBanner" src="https://ai.google.dev/static/site-assets/images/share-ais-513315318.png" />
+</div>
+
+# Run and deploy your AI Studio app
+
+This contains everything you need to run your app locally.
+
+View your app in AI Studio: https://ai.studio/apps/3b8c6a97-eb59-4fb0-aade-3976e82644b1
+
+## Run Locally
+
+**Prerequisites:**  Node.js
+
+
+1. Install dependencies:
+   `npm install`
+2. Set the `GEMINI_API_KEY` in [.env.local](.env.local) to your Gemini API key
+3. Run the app:
+   `npm run dev`

apps/blogs/README.md

@@ -0,0 +1,38 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+
+@theme {
+  --font-sans: var(--font-geist), ui-sans-serif, system-ui, sans-serif;
+  --font-display: var(--font-geist), ui-sans-serif, system-ui, sans-serif;
+  --font-mono: var(--font-geist-mono), ui-monospace, SFMono-Regular, monospace;
+  --font-serif: var(--font-instrument-serif), ui-serif, Georgia, serif;
+
+  --color-bg-base: #fcfcfd;
+  --color-text-base: #0a0a0a;
+  --color-text-secondary: #3f3f46;
+  --color-text-muted: #71717a;
+  --color-brand-blue: #1456f0;
+  --color-brand-pink: #ea5ec1;
+  --color-border-light: #f2f3f5;
+  --color-border-gray: #e5e7eb;
+}
+
+@layer base {
+  html, body {
+    background-color: #fcfcfd !important;
+    color: #0a0a0a;
+    margin: 0;
+    padding: 0;
+    width: 100%;
+    height: 100%;
+  }
+}
+
+@layer utilities {
+  .grid-paper {
+    background-image:
+      linear-gradient(to right, rgba(20, 86, 240, 0.04) 1px, transparent 1px),
+      linear-gradient(to bottom, rgba(20, 86, 240, 0.04) 1px, transparent 1px);
+    background-size: 56px 56px;
+  }
+}

apps/blogs/app/globals.css

@@ -0,0 +1,36 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono, Instrument_Serif } from "next/font/google";
+import "./globals.css";
+
+const geist = Geist({ subsets: ["latin"], variable: "--font-geist" });
+const geistMono = Geist_Mono({ subsets: ["latin"], variable: "--font-geist-mono" });
+const instrumentSerif = Instrument_Serif({
+  weight: "400",
+  subsets: ["latin"],
+  variable: "--font-instrument-serif",
+});
+
+export const metadata: Metadata = {
+  title: "Vectorless Blog | Document Retrieval for the Reasoning Era",
+  description: "Insights, deep dives, and technical guides on structure-preserving retrieval, RAG, and AI agent memory.",
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html
+      lang="en"
+      className={`${geist.variable} ${geistMono.variable} ${instrumentSerif.variable}`}
+    >
+      <body
+        className="bg-[#FCFCFD] text-[#0A0A0A] font-sans antialiased selection:bg-[#bfdbfe] selection:text-[#1d4ed8]"
+        suppressHydrationWarning
+      >
+        {children}
+      </body>
+    </html>
+  );
+}