[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-70550":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":9,"language":10,"languages":8,"totalLinesOfCode":8,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":8,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":8,"createdAt":8,"pushedAt":8,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":15,"starSnapshotCount":15,"syncStatus":26,"lastSyncTime":27,"discoverSource":28},70550,"worldwideview","silvertakana\u002Fworldwideview","silvertakana",null,"https:\u002F\u002Fgithub.com\u002Fsilvertakana\u002Fworldwideview","TypeScript",1522,377,25,12,0,43,79,332,129,20.73,false,"main","2026-06-12 02:02:34","\u003Cdiv align=\"center\">\n\n\u003C!-- Generated: 2026-04-23 06:11:00 UTC -->\n# WorldWideView\n\n**The Open-Source, Plugin-Driven Geospatial Intelligence Engine**\n\n*A modular situational awareness platform designed to ingest live data streams and render them as interactive, cinematic layers on a high-fidelity CesiumJS 3D globe.*\n\n[![CI Build](https:\u002F\u002Fgithub.com\u002Fsilvertakana\u002Fworldwideview\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fsilvertakana\u002Fworldwideview\u002Factions\u002Fworkflows\u002Fci.yml)\n[![Codecov](https:\u002F\u002Fimg.shields.io\u002Fcodecov\u002Fc\u002Fgithub\u002Fsilvertakana\u002Fworldwideview.svg)](https:\u002F\u002Fcodecov.io\u002Fgh\u002Fsilvertakana\u002Fworldwideview)\n[![NPM Version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@worldwideview\u002Fwwv-plugin-sdk.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@worldwideview\u002Fwwv-plugin-sdk)\n[![GitHub Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fsilvertakana\u002Fworldwideview?sort=semver)](https:\u002F\u002Fgithub.com\u002Fsilvertakana\u002Fworldwideview\u002Freleases)\n[![Contributors](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fsilvertakana\u002Fworldwideview.svg)](https:\u002F\u002Fgithub.com\u002Fsilvertakana\u002Fworldwideview\u002Fgraphs\u002Fcontributors)\n\u003Cbr>\n[![Next.js 16](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNext.js-16-black?logo=next.js)](https:\u002F\u002Fnextjs.org\u002F)\n[![CesiumJS](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCesium-JS-4272D0)](https:\u002F\u002Fcesium.com\u002F)\n[![TypeScript Strict](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTypeScript-Strict-3178C6?logo=typescript)](https:\u002F\u002Fwww.typescriptlang.org\u002F)\n[![Docker](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocker-Multi--Stage-2496ED?logo=docker)](https:\u002F\u002Fwww.docker.com\u002F)\n[![License: Elastic 2.0](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Elastic_2.0-blue.svg)](LICENSE)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1481088998750294139?color=7289da&label=discord&logo=discord)](#)\n[![PRs Welcome](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-welcome-brightgreen.svg)](https:\u002F\u002Fmakeapullrequest.com)\n\n![WorldWideView Interface](docs\u002Fassets\u002Fscreenshot.png)\n\n\u003C\u002Fdiv>\n\n---\n\nWorldWideView is a real-time geospatial engine visualizing live global data on an interactive 3D globe. Utilizing a dynamic \"All-Bundle\" plugin architecture, independent data sources—like live aircraft, maritime vessels, or conflict events—are ingested and rendered decoupled from the core 3D viewer.\n\n## Key Features\n\n- **\"All-Bundle\" Plugin Architecture**: Ingest any data source dynamically without touching the core platform.\n- **High-Fidelity 3D Rendering**: Google Photorealistic 3D Tiles and LOD modeling powered by CesiumJS.\n- **Real-Time Data Pipeline**: High-frequency WebSocket updates managed by a custom `DataBus`.\n- **Advanced Entity Management**: Automatic horizon culling, chunked primitive rendering, and 3D stacking\u002Fspiderification.\n- **Marketplace Integration**: Download and sync new plugins directly from the UI.\n- **Agent Bus (opt-in)**: HTTP+SSE control surface that lets an external tool — typically an MCP server fronting an LLM — fly the globe, toggle layers, and select entities in the running browser session. Default off; see [Agent Bus docs](docs\u002Fagent-bus.md).\n\n## Core Technologies\n\n- **Frontend:** Next.js 16 (App Router), React 19, TypeScript 5\n- **3D Engine:** CesiumJS + Resium (Google Photorealistic 3D Tiles)\n- **State Management:** Zustand\n- **Event Bus:** Custom typed `DataBus` for high-frequency WebSocket updates\n- **Database:** PostgreSQL via Prisma 7\n- **Deployment:** Docker multi-stage build, Coolify\n\n## Project Architecture\n\nWorldWideView separates the data acquisition layer from the frontend rendering loop, using a real-time event bus to bridge them.\n\n```mermaid\nflowchart TD\n    subgraph Data Sources\n    A[Public APIs] -->|Poll| B[Data Engine Seeders]\n    C[Microservices] -->|Stream| B\n    end\n\n    subgraph Frontend Pipeline\n    B -->|WebSocket \u002Fstream| D[DataBus & WsClient]\n    D -->|Hydrate| E[Zustand Store]\n    E -->|Memoized Entities| F[Entity Renderer]\n    F -->|Primitives| G[CesiumJS Globe]\n    end\n\n    subgraph Plugins\n    H[Plugin Registry] -->|Load| I[Dynamic Import CDNs]\n    end\n    \n    H -.-> D\n```\n\n## Prerequisites\n\nBefore running the application, ensure you have the following installed:\n- [Node.js](https:\u002F\u002Fnodejs.org\u002F) (v18+)\n- [pnpm](https:\u002F\u002Fpnpm.io\u002F) (v9+)\n- [Docker](https:\u002F\u002Fwww.docker.com\u002F) (for self-hosting or full local dev)\n- PostgreSQL (or rely on the `coolify-db` \u002F local compose container)\n\n## Quick Start (Self-Hosting)\n\nWorldWideView uses a multi-stage Dockerfile designed for standalone output. To deploy instantly on your own server:\n\n**Mac\u002FLinux:**\n```bash\nmkdir worldwideview && cd worldwideview\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsilvertakana\u002Fworldwideview\u002Fmain\u002Fself-host\u002Fsetup.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nmkdir worldwideview; cd worldwideview\nInvoke-WebRequest -Uri https:\u002F\u002Fraw.githubusercontent.com\u002Fsilvertakana\u002Fworldwideview\u002Fmain\u002Fself-host\u002Fsetup.ps1 -UseBasicParsing | Invoke-Expression\n```\n\n> [!NOTE]\n> Ensure you connect a PostgreSQL database via the `DATABASE_URL` environment variable for production deployments.\n\n## Quick Start (Local Development)\n\nTo run the source code locally for contributing or developing:\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fsilvertakana\u002Fworldwideview.git\ncd worldwideview\npnpm install\npnpm run setup   # generates .env.local with AUTH_SECRET\npnpm run dev:all # boots the UI, cache layers, and the data engine\n```\nVisit `http:\u002F\u002Flocalhost:3000` to see the live globe.\n\n## Project Structure\n\nThe codebase utilizes a `pnpm` monorepo configuration:\n\n```text\nworldwideview\u002F\n├── src\u002F                  # Core frontend app\n│   ├── app\u002F              # Next.js App Router (pages, API routes)\n│   ├── components\u002F       # Shared UI, Globe panels, and 3D layouts\n│   ├── core\u002F             # DataBus, Polling, PluginManager, Store\n│   └── plugins\u002F          # Built-in plugins and registry logic\n├── packages\u002F             # Monorepo packages\n│   ├── wwv-plugin-sdk\u002F   # SDK interfaces and manifest schemas\n│   └── wwv-plugin-*\u002F     # Individual plugins & their backends\n├── prisma\u002F               # Database schemas & migrations\n└── .agents\u002F              # Agent rules, workflows, and documentation\n```\n\n## Plugin Ecosystem\n\nWorldWideView operates on an open-core philosophy. The platform itself is data-agnostic; all data sources are dynamically imported as plugins at runtime.\n\n- **[Plugin Quickstart Guide](docs\u002Fplugin-quickstart.md)**: Learn how to scaffold and link your first plugin using the `@worldwideview\u002Fcli`.\n- **[Advanced Plugin Guide](docs\u002Fplugin-advanced.md)**: Deep dive into microservice data seeders, WebSockets, complex 3D rendering, and Marketplace publishing.\n\n## Repository Ecosystem\n\nWorldWideView is distributed across several specialized repositories:\n\n1. **`worldwideview`** (This Repo): Main frontend, CesiumJS rendering engine, and core plugin framework.\n2. **`wwv-data-engine`**: Open-source community data backend for polling public APIs.\n3. **`worldwideview-plugins`**: First-party maintained plugins.\n4. **`worldwideview-marketplace`**: The web application driving the plugin directory.\n5. **`worldwideview-web`**: Marketing and landing site.\n6. **[`szski\u002Fwwv-mcp`](https:\u002F\u002Fgithub.com\u002Fszski\u002Fwwv-mcp)**: Reference MCP server for driving the globe from an LLM agent (Claude Code, Claude Desktop, Cursor, Cline, …) via the [Agent Bus](docs\u002Fagent-bus.md). Contributor-hosted today; may move under the project org.\n\n## Development & Workflow\n\n- **Branching & Commits:** We strictly enforce [Conventional Commits](https:\u002F\u002Fwww.conventionalcommits.org\u002F) (`feat:`, `fix:`, `refactor:`). Every commit should utilize our semantic versioning `[\u002Fcommit]` workflow.\n- **Coding Standards:** We emphasize vanilla CSS (no Tailwind), strict TypeScript 5, and file modularity (max 150 lines per file).\n- **Testing:** We use Vitest with `jsdom`. All new core logic should be accompanied by tests, running via `pnpm test`.\n\nSee [Docs: Development](docs\u002Fdevelopment.md) and [Docs: Testing](docs\u002Ftesting.md) for more details.\n\n## Contributing\n\nWe welcome community contributions! Please review our coding standards and PR processes before submitting code. For detailed instructions on local development and setting up your environment, see our [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nThis project is licensed under the Elastic License 2.0 - see the [LICENSE](LICENSE) file for details.\n\n## Documentation Index\n\nExplore our comprehensive documentation suite for detailed engineering insights:\n\n- **[Project Overview](docs\u002Fproject-overview.md)**: High-level value proposition and technology stack.\n- **[Architecture](docs\u002FARCHITECTURE.md)**: Plugin system, state management, data pipeline, and Cesium rendering deep-dive.\n- **[Build System](docs\u002Fbuild-system.md)**: Monorepo structure, Next.js standalone output, and Docker builds.\n- **[Development](docs\u002Fdevelopment.md)**: Coding conventions and common implementation patterns.\n- **[Testing](docs\u002Ftesting.md)**: Vitest setup and coverage targets.\n- **[Deployment](docs\u002Fdeployment.md)**: Coolify integration and persistent volumes.\n- **[Agent Bus](docs\u002Fagent-bus.md)**: Wiring an MCP server (or any external tool) to drive the running globe.\n- **[Files Catalog](docs\u002Ffiles.md)**: Comprehensive mapping of core source files.\n\n> [!IMPORTANT]\n> **Fair-Use Notice:** This application may contain copyrighted material the use of which has not always been specifically authorized by the copyright owner. Such material is made available for educational purposes, situational awareness, and to advance understanding of global events under \"fair use\" (Section 107 of the US Copyright Law).\n","WorldWideView是一个实时地理空间引擎，能够在交互式3D地球上可视化全球实时数据。其核心功能包括“全捆绑”插件架构，允许动态接入各种独立数据源（如实时航班、海上船只或冲突事件），而无需修改核心平台代码；高保真度的3D渲染技术，利用CesiumJS提供逼真的3D瓦片和细节层次模型；以及通过自定义`DataBus`管理的高频WebSocket更新以支持实时数据流处理。此外，它还具备高级实体管理特性，比如自动视平线剔除、分块原语渲染及3D堆叠\u002F蜘蛛化展示等。WorldWideView非常适合需要在高度互动且视觉效果出色的三维地球仪上展示复杂时空数据的应用场景，如航空监控、海洋追踪、灾害响应规划等领域。",2,"2026-06-11 03:32:45","trending"]