Skip to content

Move docs deployment to Vercel and releases - #1

Merged
caorushizi merged 7 commits into
masterfrom
codex/vercel-github-releases-docs
May 17, 2026
Merged

Move docs deployment to Vercel and releases#1
caorushizi merged 7 commits into
masterfrom
codex/vercel-github-releases-docs

Conversation

@caorushizi

Copy link
Copy Markdown
Contributor

Summary

  • move docs/install script public URLs to 1cli.dev and GitHub repo links to 1cli-team/one-cli
  • switch install.sh and update checks from OSS /dl endpoints to GitHub Releases assets/latest redirect
  • remove OSS mirroring from release workflows and add Vercel static deploy configs for repo-root and apps/docs-root projects
  • update templates, skills, README, and docs to use the new public domain

Verification

  • bash -n apps/docs/public/install.sh
  • local fake-release install flow through install.sh
  • go test ./internal/updatecheck
  • go test -run TestInstallSh ./internal/cli
  • pnpm --dir apps/docs build
  • task verify-docs
  • git diff --check

Copilot AI review requested due to automatic review settings May 17, 2026 13:18
@vercel

vercel Bot commented May 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
one-cli-docs Ready Ready Preview, Comment May 17, 2026 1:59pm

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 updates One CLI’s public distribution and documentation hosting by moving the docs site to Vercel, switching installer/update checks to GitHub Releases, and standardizing public URLs/links on the new 1cli.dev domain and 1cli-team/one-cli repository.

Changes:

  • Add Vercel deployment configuration (repo root + apps/docs) and adjust docs CI to build-only (no OSS sync).
  • Migrate install.sh and CLI update checks from /dl/* endpoints to GitHub Releases (/releases/latest redirect + release assets).
  • Update README, templates, skills, and docs content to use https://1cli.dev and https://github.com/1cli-team/one-cli.

Reviewed changes

Copilot reviewed 47 out of 47 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
vercel.json Adds repo-root Vercel config to build/export docs and set headers for install.sh.
apps/docs/vercel.json Adds apps/docs-root Vercel config mirroring the static export build and install.sh headers.
.github/workflows/docs.yml Converts docs workflow to a build-only confidence check for PRs/pushes (Vercel handles prod deploy).
.github/workflows/cli.yml Removes OSS mirroring and refines dispatch behavior for releasing via GoReleaser/GitHub Releases.
.goreleaser.yaml Updates release owner and documentation comments to match GitHub Releases as the install source.
apps/docs/next.config.mjs Updates comments to reflect Vercel static hosting assumptions.
apps/docs/public/install.sh Switches “latest version” resolution and downloads to GitHub Releases redirect + release assets; updates env vars.
packages/cli/internal/updatecheck/checker.go Uses GitHub Releases “latest” redirect as version source and extracts tag from redirected path.
packages/cli/internal/updatecheck/checker_test.go Adds test coverage for GitHub-style redirect behavior.
packages/cli/internal/updatecheck/notify.go Updates the suggested install command to https://1cli.dev/install.sh.
packages/cli/internal/updatecheck/semver.go Updates comments to reflect “latest release” endpoint behavior.
packages/cli/internal/updatecheck/background.go Updates comments describing timing assumptions with the new endpoint.
packages/cli/internal/cli/install_sh_test.go Updates comments to reflect docs-site distribution + GitHub Releases dependency.
README.md Updates install/docs/release links to 1cli.dev and 1cli-team/one-cli.
CONTRIBUTING.md Updates repo/docs links and documents Vercel deployment settings.
CLAUDE.md Updates docs hosting reference to 1cli.dev.
apps/docs/src/app/layout.tsx Updates metadataBase to https://1cli.dev.
apps/docs/src/app/sitemap.ts Updates sitemap base URL to https://1cli.dev.
apps/docs/src/app/layout.config.tsx Updates changelog URL to the new GitHub org.
apps/docs/src/components/site-top-nav.tsx Updates GitHub/changelog links to the new org.
apps/docs/src/components/template-examples-nav.tsx Updates GitHub/changelog links to the new org.
apps/docs/src/app/docs/docs-toc.tsx Updates “Edit on GitHub” and issues links to the new org.
apps/docs/src/app/[lang]/docs/[[...slug]]/page.tsx Updates “Edit on GitHub” link to the new org.
apps/docs/src/app/[lang]/tutorials/[[...slug]]/page.tsx Updates “Edit on GitHub” link to the new org.
apps/docs/src/app/[lang]/blog/[slug]/page.tsx Updates “Edit on GitHub” link to the new org.
apps/docs/src/app/(home)/home-page.tsx Updates install command string and GitHub/changelog/release links to the new domain/org.
apps/docs/src/app/(home)/home-template-preview.tsx Updates displayed domain string to 1cli.dev.
apps/docs/content/docs/zh/installation.md Updates installer/docs text to describe GitHub Releases “latest” redirect + assets.
apps/docs/content/docs/en/installation.md Same as above for English installation docs.
apps/docs/content/docs/zh/skills.md Updates repo links for skill references to the new org.
apps/docs/content/docs/en/skills.md Same as above for English skills doc.
apps/docs/content/tutorials/zh/templates.mdx Updates templates tutorial link to 1cli.dev.
apps/docs/content/tutorials/en/templates.mdx Same as above for English templates tutorial.
apps/docs/content/tutorials/zh/first-workspace.mdx Updates install command to https://1cli.dev/install.sh.
apps/docs/content/tutorials/en/first-workspace.mdx Same as above for English first-workspace tutorial.
apps/docs/content/tutorials/zh/env-multi-env.mdx Updates CI snippet install command to https://1cli.dev/install.sh.
apps/docs/content/tutorials/en/env-multi-env.mdx Same as above for English env-multi-env tutorial.
apps/docs/content/tutorials/zh/json-output-error-codes.mdx Updates CI snippet install command to https://1cli.dev/install.sh.
apps/docs/content/tutorials/en/json-output-error-codes.mdx Same as above for English json-output tutorial.
packages/skills/one-cli/SKILL.md Updates install instructions and repo/error-code links to the new domain/org.
packages/skills/one-migrate/SKILL.md Updates install instructions and repo/error-code links to the new domain/org.
packages/templates/starlight-docs/src/content/docs/index.mdx Updates docs site link to 1cli.dev.
packages/templates/react-spa/src/pages/Home.tsx Updates quick-start docs link to 1cli.dev.
packages/templates/nextjs-app/src/app/page.tsx Updates quick-start docs link to 1cli.dev.
packages/templates/expo-mobile/src/app/(tabs)/index.tsx Updates quick-start docs link to 1cli.dev.
packages/templates/electron-app/apps/ui/src/nodes/HomePage/index.tsx Updates quick-start docs link to 1cli.dev.
packages/templates/astro-site/src/components/Welcome.astro Updates quick-start docs link to 1cli.dev.

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

Comment thread README.md
- [Command reference](https://one.torchstellar.com/docs/reference/cli-overview/)
- [Error codes](https://one.torchstellar.com/docs/reference/error-codes/)
- [Installation](https://1cli.dev/docs/installation/)
- [First project tutorial](https://1cli.dev/tutorials/first-workspace/)
Comment on lines +16 to +18
// latestEndpoint is the source of truth. GitHub redirects this URL to
// /releases/tag/vX.Y.Z, which avoids the unauthenticated API rate limit.
const latestEndpoint = "https://github.com/1cli-team/one-cli/releases/latest"
err "failed to fetch /dl/latest. Set ONE_VERSION=vX.Y.Z to bypass."
info "resolving latest version from $ONE_LATEST_URL"
local effective_url
if ! effective_url=$(curl -fsSL --retry 3 -o /dev/null -w '%{url_effective}' "$ONE_LATEST_URL" 2>/dev/null); then
@caorushizi
caorushizi merged commit 6c2129b into master May 17, 2026
7 checks passed
@caorushizi
caorushizi deleted the codex/vercel-github-releases-docs branch May 17, 2026 14:00
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