Skip to content

Add public roadmap, VitePress documentation site, and GitHub Pages deployment#3

Merged
huangyiirene merged 12 commits intomainfrom
copilot/create-development-plan-document
Jan 13, 2026
Merged

Add public roadmap, VitePress documentation site, and GitHub Pages deployment#3
huangyiirene merged 12 commits intomainfrom
copilot/create-development-plan-document

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Jan 13, 2026

Created a user-facing public roadmap document (docs/ROADMAP.md) in English showing what features are coming and when users can expect them. Written sincerely for end users to help them evaluate Object UI and plan adoption.

Additionally, initialized a complete VitePress documentation site with protocol specifications in the root docs/ directory and set up automated GitHub Pages deployment.

Roadmap Document

  • Vision: Clear explanation of what Object UI is and who it's for ("JSON to world-class UI in minutes")

  • What Makes Us Different: User benefits explained simply (3x faster, 6x smaller bundles, easy to learn, full control)

  • Release Timeline: Quarterly feature releases (Q1-Q4 2026):

    • Q1 2026 (March): Foundation - 20+ components, schema rendering, playground
    • Q2 2026 (June): Power Features - data management, advanced components, themes
    • Q3 2026 (September): Visual Designer - drag-and-drop, AI assistance, collaboration
    • Q4 2026 (December): Enterprise - security, scale, internationalization
  • Feature Examples: Practical code snippets showing how to use each feature

  • What You Can Do Today: Available actions (try preview, star on GitHub, provide feedback)

  • Beyond 2026: Future vision (multi-framework, cross-platform, AI, 3D)

  • FAQ: 7 common questions answered (production-ready date, pricing, compatibility, migration)

  • Stay Updated: How to follow progress (GitHub, email)

296-line English markdown document focused entirely on user value. Each quarterly release includes practical examples and "What this means for you" benefit statements. Written in conversational, approachable language without internal planning details.

VitePress Documentation Site

Created a complete documentation site in the root docs/ directory with:

Structure:

  • Homepage with hero section, features, and quick examples
  • Guide section (Introduction, Quick Start, Installation)
  • Protocol specifications (8 protocol docs: Object, View, Page, Form, Menu, App, Report, Overview)
  • API documentation (Core, React, Components, Designer)
  • Public roadmap integrated

Features:

  • VitePress 1.6.4 configuration with navigation and sidebar
  • Local search functionality
  • Dark/light theme support
  • Mobile responsive design
  • GitHub integration

Commands:

  • pnpm docs:dev - Start development server
  • pnpm docs:build - Build for production
  • pnpm docs:preview - Preview production build

Integration:

  • Documentation at root docs/ directory
  • Workspace configuration for object-ui-docs package
  • All protocol specifications from docs/objectql/ integrated

GitHub Pages Deployment

Automated Workflow (.github/workflows/deploy-docs.yml):

  • Triggers automatically on push to main branch when docs change
  • Manual deployment option via workflow_dispatch
  • Uses Node 20, pnpm 8 with caching for fast builds
  • Builds documentation and deploys to GitHub Pages
  • Will be available at: https://objectql.github.io/object-ui/

Configuration:

  • VitePress base path set to /object-ui/ for GitHub Pages
  • Build output directory: docs/.vitepress/dist/
  • Ignores dead links for legacy documentation
  • Build output added to .gitignore

Requirements:

  • GitHub Pages must be enabled in repository settings
  • Source should be set to "GitHub Actions"
  • Workflow permissions should allow writing to Pages

The documentation site is now at the root level and will automatically deploy to GitHub Pages on every push to main! 🚀

Original prompt

我要做全球最顶级的界面构建工具,帮我写开发计划文档


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Copilot AI changed the title [WIP] Add development plan document for UI building tool Add comprehensive development plan document for world-class interface builder Jan 13, 2026
Copilot AI requested a review from huangyiirene January 13, 2026 12:40
@huangyiirene
Copy link
Copy Markdown
Contributor

用英文编写,诚恳地给最终用户看 @copilot

Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Jan 13, 2026

用英文编写,诚恳地给最终用户看 @copilot

Replaced the Chinese document with a comprehensive English version (docs/DEVELOPMENT_PLAN.md) written sincerely for end users. The document explains our vision, technical advantages, and roadmap in an accessible way while maintaining professional depth.

Commit: 20b50be

@huangyiirene
Copy link
Copy Markdown
Contributor

@copilot 注意,这个文档是要给最终用户看的,不是内部文件

Copilot AI and others added 4 commits January 13, 2026 12:53
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
@huangyiirene
Copy link
Copy Markdown
Contributor

@copilot 现在初始化文档库,订立协议规范,基于这个文档库搭建vitepress

Copy link
Copy Markdown
Contributor Author

Copilot AI commented Jan 13, 2026

@copilot 注意,这个文档是要给最终用户看的,不是内部文件

Understood! I've completely rewritten it as a public roadmap for end users. Removed all internal details (team structure, budget, risk management) and focused on what users will get and when. The new docs/ROADMAP.md shows quarterly features with examples, benefits, and an FAQ section.

Commit: 409bc37

Copilot AI changed the title Add comprehensive development plan document for world-class interface builder Add public roadmap for end users Jan 13, 2026
Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Jan 13, 2026

@copilot 现在初始化文档库,订立协议规范,基于这个文档库搭建vitepress

Completed! Initialized VitePress documentation site with full protocol specifications:

  • ✅ Created apps/docs/ with VitePress
  • ✅ 20+ pages: guides, protocol specs, API docs, roadmap
  • ✅ Configured navigation and sidebar structure
  • ✅ Integrated with pnpm workspace
  • ✅ Added docs scripts: pnpm docs:dev, docs:build, docs:preview

VitePress is running successfully. Start with: pnpm docs:dev

Commit: 49cc7ec

Copilot AI changed the title Add public roadmap for end users Add public roadmap and initialize VitePress documentation site Jan 13, 2026
@huangyiirene
Copy link
Copy Markdown
Contributor

@copilot docs在根目录就可以,然后编写自动化工作流把它发布成GitHub的网站

Co-authored-by: huangyiirene <7665279+huangyiirene@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Jan 13, 2026

@copilot docs在根目录就可以,然后编写自动化工作流把它发布成GitHub的网站

Done! Moved docs to root directory and added automated GitHub Pages deployment:

  • ✅ Documentation now in docs/ at root level
  • ✅ Created .github/workflows/deploy-docs.yml for automatic deployment
  • ✅ Configured VitePress with base path /object-ui/
  • ✅ Tested build successfully

The workflow will automatically deploy to GitHub Pages when changes are pushed to main. Site will be at: https://objectql.github.io/object-ui/

Commit: 9f1735e

Copilot AI changed the title Add public roadmap and initialize VitePress documentation site Add public roadmap, VitePress documentation site, and GitHub Pages deployment Jan 13, 2026
@huangyiirene huangyiirene requested review from Copilot and removed request for huangyiirene January 13, 2026 13:14
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR establishes a comprehensive documentation infrastructure by creating a public roadmap document, initializing a VitePress documentation site with protocol specifications, and configuring automated GitHub Pages deployment for the Object UI project.

Changes:

  • Created user-facing public roadmap (docs/ROADMAP.md) outlining quarterly 2026 feature releases with practical examples and user-benefit focus
  • Initialized VitePress documentation site with homepage, guides, protocol specifications, and API references
  • Set up automated GitHub Pages deployment workflow with pnpm caching and build optimization

Reviewed changes

Copilot reviewed 23 out of 25 changed files in this pull request and generated no comments.

Show a summary per file
File Description
docs/ROADMAP.md 295-line English roadmap with Q1-Q4 2026 release timeline, feature examples, FAQ, and user-focused benefit statements
docs/.vitepress/config.mts VitePress configuration with navigation, sidebar structure, search, and GitHub Pages base path
.github/workflows/deploy-docs.yml GitHub Actions workflow for automated documentation deployment with Node 20 and pnpm 8
docs/protocol/*.md Eight protocol specification files (object, view, page, form, menu, app, report, overview) defining metadata schemas
docs/guide/*.md Three guide files (introduction, quick-start, installation) for getting started documentation
docs/api/*.md Four API reference files (core, react, components, designer) documenting package APIs
docs/index.md VitePress homepage with hero section, features grid, and quick examples
docs/package.json Workspace package configuration with VitePress 1.0.0 and dev/build/preview scripts
pnpm-workspace.yaml Added docs directory to workspace packages
package.json Added workspace entry and npm scripts for docs:dev, docs:build, docs:preview

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@huangyiirene huangyiirene marked this pull request as ready for review January 13, 2026 13:38
Introduces a new SVG logo in docs/public/logo.svg featuring a gradient background and UI layout symbols. This asset can be used for branding or documentation visuals.
@huangyiirene huangyiirene merged commit e8a8338 into main Jan 13, 2026
1 of 5 checks passed
Copilot AI added a commit that referenced this pull request Jan 24, 2026
- Fix handleExportCSV to guard on gridRef.current?.api (issue #1)
- Add dedicated onContextMenuAction callback instead of overloading onCellClicked (issue #2)
- Remove icon property from customItems to prevent HTML injection (issue #3)
- Remove validation claim from README - only basic AG Grid editing (issue #4)
- Add test assertions for all new inputs (editable, exportConfig, etc.) (issue #5)
- Fix onExport type to only support 'csv' format (issue #6)
- Remove unused ColumnConfig properties (autoSize, groupable) (issue #9)
- Type schema props with proper interfaces instead of 'any' (issue #10)
- Update export description to only mention CSV (issue #11)
- Add AG Grid Community vs Enterprise section to docs (issue #8)
- Update README and docs with new callback and clarifications

All tests pass (8/8), lint clean (0 errors)

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>
Copilot AI added a commit that referenced this pull request Feb 20, 2026
…warning, i18n fallback

- Issue #1: Normalize `in`/`not in` operators to backend-compatible `or`/`and` of `=`/`!=`
- Issue #2: Filter merging now validates and filters empty conditions
- Issue #3: CSV export safely serializes arrays (semicolon-separated) and objects (JSON)
- Issue #5: Request counter prevents stale data from overwriting latest results
- Issue #6: PullToRefresh resets pull distance immediately to prevent UI lock
- Issue #7: $top configurable via schema.pagination, data limit warning shown
- Issue #8: Extended i18n fallback translations for all ListView labels
- Issue #9: Defensive null checks in effectiveFields for mismatched objectDef
- Issue #10: Added FilterNormalization, Export, and DataFetch test suites

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants