Skip to content

ENG-9277: Add AI builder, Entreprise and hosting docs#6277

Merged
adhami3310 merged 9 commits intomainfrom
carlos/move-docs-from-web
Apr 3, 2026
Merged

ENG-9277: Add AI builder, Entreprise and hosting docs#6277
adhami3310 merged 9 commits intomainfrom
carlos/move-docs-from-web

Conversation

@carlosabadia
Copy link
Copy Markdown
Contributor

No description provided.

@linear
Copy link
Copy Markdown

linear bot commented Apr 2, 2026

@codspeed-hq
Copy link
Copy Markdown

codspeed-hq bot commented Apr 2, 2026

Merging this PR will not alter performance

✅ 8 untouched benchmarks


Comparing carlos/move-docs-from-web (4408b44) with main (2755a7b)

Open in CodSpeed

@carlosabadia carlosabadia marked this pull request as ready for review April 2, 2026 18:43
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps bot commented Apr 2, 2026

Greptile Summary

This PR adds a large set of new documentation pages (87 files, ~8,200 lines) covering three new areas of the Reflex platform: the AI Builder, Enterprise features, and Hosting. It also introduces a new GitHub Actions workflow (deploy_docs.yml) that automatically redeploys the docs website whenever changes land in reflex/docs/.

Key changes:

  • AI Builder docs: Full coverage of the Reflex Build product — overview, tutorial, best practices, features (secrets, file tree, IDE, MCP integrations), and app lifecycle management.
  • Enterprise docs: AG Grid, ReactFlow, Mantine components, drag-and-drop, map, and single-port proxy documentation.
  • Hosting docs: Deploy quick-start, GitHub Actions deployment, Databricks integration, compute/billing pricing, config file reference, custom domains, secrets, regions, machine types, self-hosting, and more.

Issues found:

  • In deploy-with-github-actions.md, the example YAML sets auth_token to secrets.REFLEX_PROJECT_ID instead of secrets.REFLEX_AUTH_TOKEN — a copy-paste error that will cause every user who follows the guide to fail deployment.
  • In compute.md, Charlie's billing example mistakenly says "brings Bob's bill down" (should be "Charlie's").
  • In compute.md, Fred's final charge shows $24.82 but the arithmetic gives $34.86 - $10 = $24.86.
  • The workflow sets FLY_API_TOKEN as an env var but no step uses it.

Confidence Score: 4/5

Safe to merge after fixing the auth_token secret reference in the GitHub Actions guide.

One P1 issue: deploy-with-github-actions.md hard-codes secrets.REFLEX_PROJECT_ID for auth_token instead of secrets.REFLEX_AUTH_TOKEN. Any developer who follows the guide will produce a broken workflow. The remaining findings are P2 and do not block functionality.

reflex/docs/hosting/deploy-with-github-actions.md (wrong secret name for auth_token) and reflex/docs/hosting/compute.md (name/math copy-paste errors)

Important Files Changed

Filename Overview
.github/workflows/deploy_docs.yml New CI/CD workflow for deploying docs to Reflex Cloud; contains an unused FLY_API_TOKEN env variable that should be removed
reflex/docs/hosting/deploy-with-github-actions.md New GitHub Actions deployment guide; has a critical copy-paste error where auth_token references secrets.REFLEX_PROJECT_ID instead of secrets.REFLEX_AUTH_TOKEN
reflex/docs/hosting/compute.md New billing/compute doc with per-second pricing examples; has a name copy-paste error and a $0.04 math discrepancy in Fred's example
reflex/docs/ai_builder/overview/what_is_reflex_build.md New overview doc for Reflex Build AI platform with feature cards and UI screenshots; no issues found
reflex/docs/ai_builder/integrations/mcp_installation.md New MCP integration installation guide covering Claude Code, Claude Desktop, Windsurf, and Codex; no issues found
reflex/docs/hosting/databricks.md New guide for deploying Reflex apps on Databricks Apps platform; no issues found
reflex/docs/enterprise/ag_grid/index.md New comprehensive AG Grid overview documentation with code examples; no issues found
reflex/docs/hosting/config_file.md New cloud config file reference documentation; no issues found

Sequence Diagram

sequenceDiagram
    participant GH as GitHub (push to main)
    participant WF as deploy_docs.yml workflow
    participant RW as reflex-web repo
    participant UV as uv / Python env
    participant RC as Reflex Cloud

    GH->>WF: Push to main (reflex/docs/** changed)
    WF->>WF: actions/checkout (this repo)
    WF->>RW: actions/checkout reflex-dev/reflex-web
    WF->>UV: astral-sh/setup-uv (Python 3.12)
    UV->>RW: uv sync --locked --no-dev
    UV->>UV: uv pip install . (local reflex with new docs)
    UV->>UV: uv pip install reflex-hosting-cli -U
    WF->>RC: reflex deploy --token PRD_TOKEN --config cloud-prod.yml
Loading

Reviews (1): Last reviewed commit: "revert that" | Re-trigger Greptile

Comment thread reflex/docs/hosting/deploy-with-github-actions.md
Comment thread .github/workflows/deploy_docs.yml
Comment thread reflex/docs/hosting/compute.md
Comment thread reflex/docs/hosting/compute.md
@adhami3310 adhami3310 merged commit 626bcdf into main Apr 3, 2026
54 of 56 checks passed
@adhami3310 adhami3310 deleted the carlos/move-docs-from-web branch April 3, 2026 19:07
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.

2 participants