# aayushgokhale2005/bugparcel-landing architecture

> Architecture diagram of the GitHub repository aayushgokhale2005/bugparcel-landing, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aayushgokhale2005/bugparcel-landing
- Repository: https://github.com/aayushgokhale2005/bugparcel-landing

## Overview

This repository is a vinext full-stack starter whose checked-in app is BugParcel’s public landing site, not the BugParcel incident-capture product described by the marketing copy. The main user flow is browsing the landing page and its setup/agent information; the starter also provides documentation, an llms.txt endpoint, optional ChatGPT identity helpers, and an optional D1 example. The Worker handles image optimization before delegating other requests to vinext. Some example and documentation internals are unsampled, so their unverified connections are omitted.

Main entry points: [`app/page.tsx`](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/page.tsx) (Landing page), [`worker/index.ts`](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/worker/index.ts) (Worker entry), [`app/docs`](https://github.com/aayushgokhale2005/bugparcel-landing/tree/main/app/docs) (Documentation pages), [`app/llms.txt/route.ts`](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/llms.txt/route.ts) (llms.txt handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Landing Site"]
  node_home["Landing page<br/>[page.tsx]"]
  node_codeblock["Code examples<br/>[CodeBlock.tsx]"]
  node_scrollweight["Scroll effects<br/>[ScrollWeight.tsx]"]
  node_layout["Root layout<br/>[layout.tsx]"]
end

subgraph group_content["Docs and Identity"]
  node_docs["Documentation pages"]
  node_docsshell["Docs shell<br/>[DocsShell.tsx]"]
  node_install["Install guide<br/>[page.tsx]"]
  node_llmsdocs["LLM guide<br/>[page.tsx]"]
  node_auth["ChatGPT auth helpers<br/>[chatgpt-auth.ts]"]
  node_llmsroute["llms.txt handler<br/>[route.ts]"]
  node_llmsbody["llms.txt content<br/>[body.txt]"]
end

subgraph group_runtime["Runtime and Data"]
  node_worker["Worker entry<br/>[index.ts]"]
  node_vinext["vinext router"]
  node_assets[("Cloudflare assets")]
  node_images["Image transform service"]
  node_dbboundary["Database boundary<br/>[index.ts]"]
  node_schema["Starter schema<br/>[schema.ts]"]
  node_d1example["D1 notes example"]
end

node_visitor(("Site visitor"))

node_visitor -->|"browses"| node_home
node_home -->|"renders examples"| node_codeblock
node_home -->|"uses effects"| node_scrollweight
node_layout -.->|"wraps page"| node_home
node_docs -.->|"uses shell"| node_docsshell
node_visitor -.->|"reads guides"| node_docs
node_visitor -.->|"requests content"| node_llmsroute
node_llmsroute -->|"reads content"| node_llmsbody
node_worker -->|"delegates requests"| node_vinext
node_worker -->|"fetches assets"| node_assets
node_worker -->|"transforms images"| node_images

click node_home "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/page.tsx"
click node_codeblock "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/CodeBlock.tsx"
click node_scrollweight "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/ScrollWeight.tsx"
click node_layout "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/layout.tsx"
click node_docs "https://github.com/aayushgokhale2005/bugparcel-landing/tree/main/app/docs"
click node_docsshell "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/docs/DocsShell.tsx"
click node_install "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/docs/install/page.tsx"
click node_llmsdocs "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/docs/llms/page.tsx"
click node_auth "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/chatgpt-auth.ts"
click node_llmsroute "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/llms.txt/route.ts"
click node_llmsbody "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/llms.txt/body.txt"
click node_worker "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/worker/index.ts"
click node_dbboundary "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/db/index.ts"
click node_schema "https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/db/schema.ts"
click node_d1example "https://github.com/aayushgokhale2005/bugparcel-landing/tree/main/examples/d1"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_codeblock,node_scrollweight,node_layout toneBlue
class node_docs,node_docsshell,node_install,node_llmsdocs,node_auth,node_llmsroute,node_llmsbody toneAmber
class node_worker,node_vinext,node_assets,node_images,node_dbboundary,node_schema,node_d1example toneMint
class node_visitor toneIndigo
```

## Components

### Landing Site

- [Landing page](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/page.tsx): `app/page.tsx`
- [Code examples](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/CodeBlock.tsx): `app/CodeBlock.tsx`
- [Scroll effects](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/ScrollWeight.tsx): `app/ScrollWeight.tsx`
- [Root layout](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/layout.tsx): `app/layout.tsx`

### Docs and Identity

- [Documentation pages](https://github.com/aayushgokhale2005/bugparcel-landing/tree/main/app/docs): `app/docs`
- [Docs shell](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/docs/DocsShell.tsx): `app/docs/DocsShell.tsx`
- [Install guide](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/docs/install/page.tsx): `app/docs/install/page.tsx`
- [LLM guide](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/docs/llms/page.tsx): `app/docs/llms/page.tsx`
- [ChatGPT auth helpers](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/chatgpt-auth.ts): `app/chatgpt-auth.ts`
- [llms.txt handler](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/llms.txt/route.ts): `app/llms.txt/route.ts`
- [llms.txt content](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/app/llms.txt/body.txt): `app/llms.txt/body.txt`

### Runtime and Data

- [Worker entry](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/worker/index.ts): `worker/index.ts`
- **vinext router**
- **Cloudflare assets**
- **Image transform service**
- [Database boundary](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/db/index.ts): `db/index.ts`
- [Starter schema](https://github.com/aayushgokhale2005/bugparcel-landing/blob/main/db/schema.ts): `db/schema.ts`
- [D1 notes example](https://github.com/aayushgokhale2005/bugparcel-landing/tree/main/examples/d1): `examples/d1`

### Other components

- **Site visitor**

## Connections

- Site visitor → Landing page: browses
- Landing page → Code examples: renders examples (evidence: `app/page.tsx`)
- Landing page → Scroll effects: uses effects (evidence: `app/page.tsx`)
- Root layout → Landing page: wraps page
- Documentation pages → Docs shell: uses shell
- Site visitor → Documentation pages: reads guides
- Site visitor → llms.txt handler: requests content
- llms.txt handler → llms.txt content: reads content (evidence: `app/llms.txt/route.ts`)
- Worker entry → vinext router: delegates requests (evidence: `worker/index.ts`)
- Worker entry → Cloudflare assets: fetches assets (evidence: `worker/index.ts`)
- Worker entry → Image transform service: transforms images (evidence: `worker/index.ts`)
