Skip to content

Commit 2dccfa5

Browse files
committed
final
1 parent 067711d commit 2dccfa5

2 files changed

Lines changed: 33 additions & 18 deletions

File tree

README.md

Lines changed: 30 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -17,27 +17,42 @@
1717

1818
---
1919

20-
## 🚀 Overview
20+
## 🚀 What is modernvroapi.in?
2121

22-
**modernvroapi.in** is a community-driven, modern replacement for legacy vRO documentation sites. Built with **React 19**, **Vite**, and **Tailwind CSS**, it provides a blazing-fast user experience with instant search, dark mode support, and deep-linking for every class and method.
22+
**modernvroapi.in** is a community-driven API reference hub for **VMware Cloud Foundation Operations Orchestrator (vRO)** plugins. It serves as a modern, high-performance replacement for legacy documentation site (vroapi.com), designed specifically for automation engineers and developers working with the vRO JavaScript SDK.
2323

24-
### ✨ Key Features
25-
- 🔍 **Universal Global Search**: Find any plugin, class, or method (over 14,000+ entries) instantly via `Ctrl+K` or `/`.
26-
-**High Performance**: Pre-indexed metadata ensures lightning-fast navigation with zero lag.
27-
- 🌓 **Dark Mode**: Native support for dark and light themes with a premium glassmorphic UI.
28-
- 📱 **Fully Responsive**: Optimized for everything from mobile phones up to 4K monitors.
29-
- 🛠 **Community Registry**: Easy "Suggest Edit" buttons on every page to keep metadata accurate via GitHub.
30-
- 🐇 **HD Branding**: Support for high-definition custom logos for specialized plugins.
24+
Its primary goal is to provide **instant access** to the complete API surface of dozens of plugins, including in-built VCF components, certified integrations, and widely used 3rd-party community plugins.
25+
26+
### 🎯 Key Capabilities
27+
- 🔍 **Universal Search**: Instantly find any plugin, class, method, or attribute (over 14,000+ entries) with sub-second latency.
28+
- 📚 **Comprehensive Coverage**: Aggregates documentation for standard plugins (vCenter, AD, SQL) and specialized integrations (F5, SRM, vSAN, Avi).
29+
- 🔗 **Deep Linking**: Every class and method has its own unique URL, making it easy to share specific API references in code comments or Slack.
30+
- ⬇️ **Download Hub**: Quick access to plugin binaries and official documentation links directly from each API page.
31+
- 🌓 **Developer-First UI**: Features like **Dark Mode**, **one-click method signature copying**, and a mobile-responsive layout designed for multi-tasking.
32+
- 🛠 **Open Contribution**: Built on an open JSON data structure, allowing the community to suggest fixes and add new plugins via GitHub.
33+
34+
---
35+
36+
## 🔍 Global Intelligent Search
37+
38+
The cornerstone of the `modernvroapi.in` experience is its **unified search engine**, specifically engineered for speed and breadth:
39+
40+
- **Unified Registry**: Simultaneously searches across **Plugins**, **Classes/Interfaces**, and **Member Methods/Attributes**.
41+
- **Blazing Performance**: All search operations happen client-side using a optimized `search-index.json`, providing results in milliseconds without any server-side roundtrips.
42+
- **Productivity Shortcuts**:
43+
- `Ctrl + K` or `/`: Instantly focuses the global search bar from anywhere on the site.
44+
- `Arrow Keys + Enter`: Rapidly navigate results without touching the mouse.
45+
- **Smart Filtering**: Results are categorized by type, allowing you to quickly jump directly to a method implementation even if you only remember part of its name.
46+
- **Deep Index**: Over **14,000 components** are currently indexed and searchable in real-time.
3147

3248
---
3349

34-
## 🛠 Tech Stack
50+
## 🏗 Project Structure
3551

36-
- **Framework**: [React 19](https://react.dev/)
37-
- **Build Tool**: [Vite](https://vitejs.dev/)
38-
- **Styling**: [Tailwind CSS](https://tailwindcss.com/)
39-
- **Icons**: [Lucide React](https://lucide.dev/)
40-
- **State/Routing**: [React Router 7](https://reactrouter.com/)
52+
- **vro-doc-site**: The main documentation web application.
53+
- **scripts**: Automation tools for scraping legacy data and re-indexing the API catalog.
54+
- **BTVA**: Source TypeScript definition files and extracted metadata for vRO plugins.
55+
- **Third-party Plugins**: A collection of community-contributed vRO plugin binaries and sources.
4156

4257
---
4358

vro-doc-site/src/data/plugin-meta.ts

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -34,17 +34,17 @@ export const PLUGIN_META: Record<string, PluginMetadata> = {
3434
'o11n-plugin-rest': { icon: Settings, color: 'green', tags: ['IN-BUILT'], version: '2.6.0.24114287' },
3535
'o11n-plugin-snmp': { icon: Waypoints, color: 'orange', tags: ['IN-BUILT'], version: '1.1.0.24114283' },
3636
'o11n-plugin-soap': { icon: Gauge, color: 'indigo', tags: ['IN-BUILT'], version: '2.1.0.24105054' },
37-
'o11n-plugin-srm': { image: `${import.meta.env.BASE_URL}icons/SRM.png`, color: 'blue', tags: ['CERTIFIED'], downloadUrl: 'https://vcf.broadcom.com/vsc/services/details/vmware-cloud-foundation-orchestrator-plug-in-for-vmware-live-site-recovery-2?slug=true', version: '9.0.4.0.24920184' },
37+
'o11n-plugin-srm': { image: `${import.meta.env.BASE_URL}icons/srm.png`, color: 'blue', tags: ['CERTIFIED'], downloadUrl: 'https://vcf.broadcom.com/vsc/services/details/vmware-cloud-foundation-orchestrator-plug-in-for-vmware-live-site-recovery-2?slug=true', version: '9.0.4.0.24920184' },
3838
'o11n-plugin-sql': { icon: Database, color: 'blue', tags: ['IN-BUILT'], version: '1.3.0.24105061' },
3939
'o11n-plugin-ssh': { icon: Terminal, color: 'slate', tags: ['IN-BUILT'], version: '8.0.1.24140733' },
4040
'o11n-plugin-support': { icon: Wrench, color: 'amber', tags: ['IN-BUILT'], version: '8.18.1.24266232' },
4141
'o11n-plugin-vapi': { image: `${import.meta.env.BASE_URL}icons/vapi.png`, color: 'yellow', tags: ['IN-BUILT'], version: '7.6.0.24140713' },
42-
'o11n-plugin-vc': { image: `${import.meta.env.BASE_URL}icons/vCenter.png`, color: 'blue', tags: ['IN-BUILT'], version: '8.1.1.24147893' },
42+
'o11n-plugin-vc': { image: `${import.meta.env.BASE_URL}icons/vcenter.png`, color: 'blue', tags: ['IN-BUILT'], version: '8.1.1.24147893' },
4343
'o11n-plugin-vcloud': { image: `${import.meta.env.BASE_URL}icons/cloud-director.png`, color: 'sky', tags: ['IN-BUILT'], version: '10.5.0' }, // Missing in list, approximating or leaving blank? User didn't provide vCloud. Let's leave it or guess. I'll omit version if unknown or guess based on similarly timed plugins if I had to, but I'll skip for now if not in list. Actually, I should probably stick to what's provided.
4444
'o11n-plugin-vco': { image: `${import.meta.env.BASE_URL}icons/vro.png`, color: 'orange', tags: ['IN-BUILT'], version: '8.18.1.24266232' },
4545
'o11n-plugin-vr': { image: `${import.meta.env.BASE_URL}icons/vr.png`, color: 'blue', tags: ['CERTIFIED'], downloadUrl: 'https://vcf.broadcom.com/vsc/services/details/vmware-cloud-foundation-orchestrator-plug-in-for-vmware-vsphere-replication-2?slug=true', version: '9.0.4.0.24920185' },
4646
'o11n-plugin-vra': { image: `${import.meta.env.BASE_URL}icons/vra.png`, color: 'cyan', tags: ['IN-BUILT'], version: '8.14.0.23221431' },
47-
'o11n-plugin-vsan': { image: `${import.meta.env.BASE_URL}icons/vSAN.png`, color: 'blue', tags: ['CERTIFIED'], downloadUrl: 'https://vcf.broadcom.com/vsc/services/details/vmware-aria-automation-orchestrator-plug-in-for-vmware-vsan-2-2-0-2?slug=true', version: '2.2.0.23824262' },
47+
'o11n-plugin-vsan': { image: `${import.meta.env.BASE_URL}icons/vsan.png`, color: 'blue', tags: ['CERTIFIED'], downloadUrl: 'https://vcf.broadcom.com/vsc/services/details/vmware-aria-automation-orchestrator-plug-in-for-vmware-vsan-2-2-0-2?slug=true', version: '2.2.0.23824262' },
4848
'o11n-plugin-vum': { icon: Download, color: 'green', tags: ['IN-BUILT'], version: '8.1.1.24105053' },
4949
'o11n-plugin-xml': { icon: FileCode, color: 'orange', tags: ['IN-BUILT'], version: '8.3.0.24114285' }
5050
};

0 commit comments

Comments
 (0)