Context7 Platform -- Up-to-date docs for AI agents
Add Docs7 documentation and component guides (#3024)
Enes Gules6d777619c277
diff --git a/docs/docs.json b/docs/docs.jsonindex 53b585ce..f1bef631 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -23,211 +23,283 @@]},"navigation": {- "groups": [+ "tabs": [{- "group": "Overview",- "pages": [- "overview",- "installation",- "plans-pricing",- "clients/cli",- "adding-libraries",- "library-owners",- "library-updates",- "api-guide",- "tips"- ]- },- {- "group": "How To",- "pages": [- {- "group": "Authentication",- "pages": [- "howto/api-keys",- "howto/oauth"- ]- },- "howto/claiming-libraries",- "howto/chat-widget",- "howto/verification",- "howto/private-sources",- "howto/policies",- "howto/rules",- "howto/usage",- "howto/teamspace"- ]- },- {- "group": "Enterprise",- "pages": [- "enterprise",+ "tab": "Context7",+ "groups": [{- "group": "Enterprise-Managed Auth",+ "group": "Overview","pages": [- "enterprise/enterprise-managed-auth/entra",- "enterprise/enterprise-managed-auth/okta"+ "overview",+ "installation",+ "plans-pricing",+ "clients/cli",+ "adding-libraries",+ "library-owners",+ "library-updates",+ "api-guide",+ "tips"]},{- "group": "On-Premise",+ "group": "How To","pages": [- "enterprise/on-premise",- "enterprise/changelog",- {- "group": "Integrations",- "pages": [- "enterprise/integrations/github",- "enterprise/integrations/other-git",- "enterprise/integrations/gerrit",- "enterprise/integrations/confluence"- ]- },{- "group": "Security",+ "group": "Authentication","pages": [- "enterprise/security/entra-sso",- "enterprise/security/oidc-sso",- "enterprise/security/library-access"- ]- },- {- "group": "Deployment",- "pages": [- "enterprise/deployment/docker",- "enterprise/deployment/kubernetes",- "enterprise/deployment/scaling",- "enterprise/deployment/vector-stores"+ "howto/api-keys",+ "howto/oauth"]},+ "howto/claiming-libraries",+ "howto/chat-widget",+ "howto/verification",+ "howto/private-sources",+ "howto/policies",+ "howto/rules",+ "howto/usage",+ "howto/teamspace"+ ]+ },+ {+ "group": "Enterprise",+ "pages": [+ "enterprise",{- "group": "Features",+ "group": "Enterprise-Managed Auth","pages": [- "enterprise/library-import",- "enterprise/automatic-repository-updates",- "enterprise/gitops",- "enterprise/backup-restore"+ "enterprise/enterprise-managed-auth/entra",+ "enterprise/enterprise-managed-auth/okta"]},{- "group": "API Reference",+ "group": "On-Premise","pages": [- "enterprise/api/authentication",+ "enterprise/on-premise",+ "enterprise/changelog",{- "group": "Search",- "pages": ["enterprise/api/search/search-for-libraries"]+ "group": "Integrations",+ "pages": [+ "enterprise/integrations/github",+ "enterprise/integrations/other-git",+ "enterprise/integrations/gerrit",+ "enterprise/integrations/confluence"+ ]},{- "group": "Context",- "pages": ["enterprise/api/context/get-documentation-context"]+ "group": "Security",+ "pages": [+ "enterprise/security/entra-sso",+ "enterprise/security/oidc-sso",+ "enterprise/security/library-access"+ ]},{- "group": "Parse",+ "group": "Deployment","pages": [- "enterprise/api/parse/parse-a-git-repository",- "enterprise/api/parse/parse-an-openapi-spec-by-url",- "enterprise/api/parse/upload-an-openapi-spec-file",- "enterprise/api/parse/import-libraries",- "enterprise/api/parse/parse-a-website",- "enterprise/api/parse/refresh-a-library",- "enterprise/api/parse/get-parse-status"+ "enterprise/deployment/docker",+ "enterprise/deployment/kubernetes",+ "enterprise/deployment/scaling",+ "enterprise/deployment/vector-stores"+ ]+ },+ {+ "group": "Features",+ "pages": [+ "enterprise/library-import",+ "enterprise/automatic-repository-updates",+ "enterprise/gitops",+ "enterprise/backup-restore"+ ]+ },+ {+ "group": "API Reference",+ "pages": [+ "enterprise/api/authentication",+ {+ "group": "Search",+ "pages": [+ "enterprise/api/search/search-for-libraries"+ ]+ },+ {+ "group": "Context",+ "pages": [+ "enterprise/api/context/get-documentation-context"+ ]+ },+ {+ "group": "Parse",+ "pages": [+ "enterprise/api/parse/parse-a-git-repository",+ "enterprise/api/parse/parse-an-openapi-spec-by-url",+ "enterprise/api/parse/upload-an-openapi-spec-file",+ "enterprise/api/parse/import-libraries",+ "enterprise/api/parse/parse-a-website",+ "enterprise/api/parse/refresh-a-library",+ "enterprise/api/parse/get-parse-status"+ ]+ }]}]}]- }- ]- },- {- "group": "Security",- "pages": [- "security/overview",- "security/data-privacy",- "security/infrastructure",- "security/auth-and-access-control",- "security/compliance-and-reporting",- "security/data-safety",- "security/best-practices"- ]- },- {- "group": "Clients",- "pages": [- "clients/claude-code",- "clients/codex",- "clients/copilot-cli",- "clients/cursor",- "clients/opencode",- "clients/pi",- "clients/vscode",- "resources/all-clients"- ]- },- {- "group": "SDKs",- "pages": [+ },+ {+ "group": "Security",+ "pages": [+ "security/overview",+ "security/data-privacy",+ "security/infrastructure",+ "security/auth-and-access-control",+ "security/compliance-and-reporting",+ "security/data-safety",+ "security/best-practices"+ ]+ },+ {+ "group": "Clients",+ "pages": [+ "clients/claude-code",+ "clients/codex",+ "clients/copilot-cli",+ "clients/cursor",+ "clients/opencode",+ "clients/pi",+ "clients/vscode",+ "resources/all-clients"+ ]+ },{- "group": "TypeScript",+ "group": "SDKs","pages": [- "sdks/ts/getting-started",{- "group": "Commands",+ "group": "TypeScript","pages": [- "sdks/ts/commands/search-library",- "sdks/ts/commands/get-context"+ "sdks/ts/getting-started",+ {+ "group": "Commands",+ "pages": [+ "sdks/ts/commands/search-library",+ "sdks/ts/commands/get-context"+ ]+ }+ ]+ }+ ]+ },+ {+ "group": "Agentic Tools",+ "pages": [+ "agentic-tools/overview",+ {+ "group": "Vercel AI SDK",+ "pages": [+ "agentic-tools/ai-sdk/getting-started",+ {+ "group": "Tools",+ "pages": [+ "agentic-tools/ai-sdk/tools/resolve-library-id",+ "agentic-tools/ai-sdk/tools/query-docs"+ ]+ },+ {+ "group": "Agents",+ "pages": [+ "agentic-tools/ai-sdk/agents/context7-agent"+ ]+ }]}]+ },+ {+ "group": "API Reference",+ "openapi": "openapi.json"+ },+ {+ "group": "Integrations",+ "pages": [+ "integrations/github-actions",+ "integrations/code-rabbit",+ "integrations/factory-ai",+ "integrations/tembo",+ "integrations/mastra",+ "integrations/eve"+ ]+ },+ {+ "group": "Resources",+ "pages": [+ "resources/developer",+ "resources/troubleshooting"+ ]}]},{- "group": "Agentic Tools",- "pages": [- "agentic-tools/overview",+ "tab": "Docs7",+ "groups": [{- "group": "Vercel AI SDK",+ "group": "Docs7",+ "pages": [+ "docs7/overview",+ "docs7/quickstart",+ "docs7/configuration",+ "docs7/migrate-from-mintlify"+ ]+ },+ {+ "group": "Product",+ "pages": [+ "docs7/builds",+ "docs7/ai-visibility",+ "docs7/analytics",+ "docs7/agent"+ ]+ },+ {+ "group": "SEO and agent readiness",+ "pages": ["docs7/seo", "docs7/agent-readiness"]+ },+ {+ "group": "Reference","pages": [- "agentic-tools/ai-sdk/getting-started",- {- "group": "Tools",- "pages": [- "agentic-tools/ai-sdk/tools/resolve-library-id",- "agentic-tools/ai-sdk/tools/query-docs"- ]- },{- "group": "Agents",+ "group": "Components","pages": [- "agentic-tools/ai-sdk/agents/context7-agent"+ "docs7/components/callouts",+ "docs7/components/cards",+ "docs7/components/columns",+ "docs7/components/tiles",+ "docs7/components/tabs",+ "docs7/components/code-groups",+ "docs7/components/steps",+ "docs7/components/accordions",+ "docs7/components/frames",+ "docs7/components/icons",+ "docs7/components/badge",+ "docs7/components/tooltips",+ "docs7/components/fields",+ "docs7/components/expandables",+ "docs7/components/examples",+ "docs7/components/panel",+ "docs7/components/tree",+ "docs7/components/color",+ "docs7/components/prompt",+ "docs7/components/updates",+ "docs7/components/view",+ "docs7/components/visibility",+ "docs7/components/github",+ "docs7/components/mermaid",+ "docs7/components/latex",+ "docs7/components/react-components"]}]}]- },- {- "group": "API Reference",- "openapi": "openapi.json"- },- {- "group": "Integrations",- "pages": [- "integrations/github-actions",- "integrations/code-rabbit",- "integrations/factory-ai",- "integrations/tembo",- "integrations/mastra",- "integrations/eve"- ]- },- {- "group": "Resources",- "pages": [- "resources/developer",- "resources/troubleshooting"- ]}]},diff --git a/docs/docs7/agent-readiness.mdx b/docs/docs7/agent-readiness.mdxnew file mode 100644index 00000000..d4d25468--- /dev/null+++ b/docs/docs7/agent-readiness.mdx@@ -0,0 +1,57 @@+---+title: Agent readiness+description: Expose searchable Markdown and structured discovery for AI agents+---++Docs7 turns each documentation page into clean Markdown for agents and publishes discovery endpoints for the full site.++## Agent-readable endpoints++Every Docs7 site publishes these machine-readable surfaces:++The paths below are relative to the documentation root. For a site mounted at `example.com/docs`, `/llms.txt` is available at `example.com/docs/llms.txt`.++| Endpoint | Purpose |+| --- | --- |+| `/llms.txt` | Lists routable pages with their Markdown URL and description. Pages in navigation come first. |+| `/llms-full.txt` | Combines the complete Markdown content of the site into one file. |+| `/<page>.md` | Returns the Markdown representation of one page. |+| `/search?q=<query>` | Searches the site and returns matching pages, headings, and snippets as JSON. |+| `/.well-known/agent-skills/index.json` | Advertises a site-specific Agent Skill with links to the docs and search. |++An agent can also request a normal page URL with `Accept: text/markdown`. Docs7 returns Markdown when the client prefers it. HTML responses advertise the Markdown page, both `llms.txt` files, and the Agent Skills index through `Link` headers.++If you provide `llms.txt` or `llms-full.txt` at the docs root, your file replaces the generated version.++## Recover from hallucinated URLs++Agents often request URLs that do not exist. They guess a path from a page title, drop a segment, or reuse a URL from an older version of the docs. Instead of returning an empty 404, Docs7 responds with smart suggestions: the pages the agent was most likely looking for, with their Markdown URLs.++<Frame caption="A request for a page that does not exist returns the closest matching pages instead of an empty 404.">+ <img+ src="/images/docs7/url-suggestions.png"+ alt="Docs7 404 page listing suggested pages for a URL that does not exist"+ />+</Frame>++For example, an agent that requests `/config.md` on a site whose page lives at `/configuration.md` receives that page as a suggestion. The agent can follow it directly without running a separate search, so a wrong guess costs one extra request instead of a dead end.++## Write content for agents++Use the same source for people and agents whenever possible. When an agent needs extra context, use `Visibility`:++```mdx+<Visibility for="agents">+When the API returns 409, read the existing resource before retrying.+</Visibility>+```++Content inside `for="agents"` appears in Markdown output but not on the website. Content inside `for="humans"` appears on the website and is removed from Markdown output. See the [Visibility component](/docs7/components/visibility).++For reliable retrieval, use exact API names, configuration keys, error messages, and stable headings. Link to the page that owns a fact instead of copying the same instructions into several pages.++## Add the site to Context7++Enable **Add to Context7** when you connect the repository, or open the **Context7** tab for an existing site. A successful production build then refreshes the corresponding Context7 library.++This makes the documentation available through the Context7 MCP server and lets the site's assistant use the indexed library. Disconnecting stops automatic refreshes but does not remove the library from Context7.diff --git a/docs/docs7/agent.mdx b/docs/docs7/agent.mdxnew file mode 100644index 00000000..d9f57d2e--- /dev/null+++ b/docs/docs7/agent.mdx@@ -0,0 +1,102 @@+---+title: Agent+description: Configure autonomous fixes, pull request reviews, and scheduled checks+---++The Docs7 Agent works from your GitHub repository and keeps every proposed change reviewable. Open **Docs7**, choose a site, then select **Agent**.++<Frame caption="The Context7 Agent keeps suggestions, build issues, its schedule, and run history in one place.">+ <img+ src="/images/docs7/dashboard/agent.jpg"+ alt="Docs7 Agent dashboard showing suggestions, build issues, scheduling, and history"+ />+</Frame>++There are three workflows:++- **Context7 Agent** fixes queued suggestions or build issues in a pull request.+- **PR Review Agent** reviews documentation changes in each eligible pull request.+- **Monthly Checkup** is a planned full-site review and is not available yet.++## Context7 Agent++The Context7 Agent has two work queues.++### Suggestions++Suggestions come from Context7's analysis of the indexed documentation. Each suggestion points to the source files that support it.++Select up to 10 suggestions and click **Run agent**. The agent verifies each suggestion against the repository and edits only the configured docs path. If it produces supported changes, Docs7 opens one pull request.++### Build issues++Build issues come from the latest live production build. The queue includes fixable page errors, broken internal links, unknown components, and source warnings.++Select up to 20 issues and run the agent. It checks each issue against the repository. If it produces supported fixes, Docs7 opens one pull request.++Ignoring a suggestion or build issue removes it from the queue. It does not remove the issue from an older build's Health report.++### Schedule++New sites start with the schedule disabled. Enable it and choose **Daily** or **Weekly**.++A scheduled run starts only when at least three suggestions are waiting. It handles up to 10 suggestions in one pull request. The schedule does not run the build issue queue automatically.++You can review completed, failed, and running work under **History**.++## PR Review Agent++The PR Review Agent runs after an eligible pull request preview finishes. It reviews only files inside the configured docs path and posts its findings in the pull request's Docs7 summary.++<Frame caption="PR Review Agent settings control its response mode and the checks applied to pull requests.">+ <img+ src="/images/docs7/dashboard/agent-pr-review.jpg"+ alt="PR Review Agent settings with response modes and documentation checks"+ />+</Frame>++New sites start with PR reviews disabled and **Comment only** selected.++### Checks++| Check | What it reviews | Default |+| --- | --- | --- |+| **Broken links** | Broken internal links, dead external links, and links to missing headings in changed docs files. | On |+| **Build health issues** | New fixable issues introduced by the preview compared with production. | On |+| **Grammar and spelling** | Mistakes in text added or changed by the pull request. | On |+| **Codebase standards in a monorepo** | Changed pages against repository instructions and nearby documentation patterns. | Off |++Build health requires a hosted Docs7 site. The other checks can also run for a repository connected only for the agent.++### Response modes++The findings comment is always posted. The response mode controls what happens to fixes:++- **Comment only** reports findings and does not change files.+- **Pull request** opens a separate pull request with supported fixes.+- **Commit** pushes supported fixes to the pull request branch. If the branch refuses the push, Docs7 opens a pull request against it instead.++Docs7 skips pull requests from forks and pull requests that do not change the configured docs path. It also skips commits created by the agent, which prevents review loops.++<Note>+Do not make **Docs7 PR Review** a required GitHub check. Fork pull requests do not receive that check.+</Note>++## Monthly Checkup++<Info>+Monthly Checkup is **coming soon**.+</Info>++The planned workflow reads the entire site once a month and opens one pull request with+- link checks+- grammar and spelling+- build health+- pages that no longer match their source+- and a code compilation check.++## Safety and scope++Agent runs receive read access to the connected repository. The agent can inspect repository source to verify a documentation change, but trusted Docs7 code publishes the resulting files through GitHub.++Changes are limited to the configured docs path. When the docs path is the repository root, Docs7 still blocks common application paths, package manifests, lockfiles, `.github`, and `.git` from agent changes.diff --git a/docs/docs7/ai-visibility.mdx b/docs/docs7/ai-visibility.mdxnew file mode 100644index 00000000..0731fef3--- /dev/null+++ b/docs/docs7/ai-visibility.mdx@@ -0,0 +1,60 @@+---+title: AI Visibility+description: See which AI agents request your docs and what they fetch+---++AI Visibility shows which AI products visit your Docs7 site. Open **Docs7**, choose a site, then select **AI Visibility**.++Choose a 7, 30, or 90 day window. If the site has branch previews, you can include their traffic. Preview traffic is excluded by default.++<Frame caption="AI Visibility ranks tracked providers and plots their activity.">+ <img+ src="/images/docs7/dashboard/ai-visibility.jpg"+ alt="Docs7 AI Visibility dashboard with provider rankings and request activity"+ />+</Frame>++## AI requests++An AI request is one visit from a tracked AI product. It is not a unique person, conversation, citation, or answer. One product can make several requests while researching a question.++The provider ranking groups requests by product. The activity chart shows request volume over time and can be filtered by provider.++## Included providers++Docs7 currently tracks:++- OpenAI+- Claude+- Perplexity+- Cursor+- OpenCode+- Meta+- Mistral++<Note>+AI Visibility shows which product made the request. It does not show the exact model version.+</Note>++## WebMCP searches++Docs7 exposes a read-only `search_docs` WebMCP tool in browsers that support WebMCP. The **WebMCP searches** table shows the most common queries sent through that tool.++These are separate from searches typed by people in the website search box. Human search terms appear under [Analytics](/docs7/analytics#searches).++## Top pages++**Top pages** ranks paths by AI request count. Use the path filter to narrow the list, then sort by most or least fetched.++A high request count shows that agents fetch a page often. It does not show whether the page was cited or whether the agent's final answer was correct.++## Recent requests++The recent request table shows:++- the detected agent or provider+- the requested path+- the request country, when available+- the request time++Use this view to confirm that a crawler reaches the expected URL or to investigate a change in provider activity.diff --git a/docs/docs7/analytics.mdx b/docs/docs7/analytics.mdxnew file mode 100644index 00000000..d747a514--- /dev/null+++ b/docs/docs7/analytics.mdx@@ -0,0 +1,52 @@+---+title: Analytics+description: Understand visitors, searches, assistant questions, and referrers+---++Analytics reports how people use your Docs7 site. Open **Docs7**, choose a site, then select **Analytics**.++Choose a 7, 30, or 90 day window. If the site has branch previews, you can include their traffic. Preview traffic is excluded by default.++<Frame caption="Analytics separates human visitors from AI traffic and shows activity for the selected period.">+ <img+ src="/images/docs7/dashboard/analytics.jpg"+ alt="Docs7 Analytics dashboard with visitor totals and visitor activity"+ />+</Frame>++## Visitors and views++Docs7 records a page view for a document navigation from a browser after filtering known AI crawlers and generic bots.++| Metric | Meaning |+| --- | --- |+| **Visitors** | Privacy-preserving daily visitor identifiers in the selected window. |+| **Views** | Document page views in the selected window. |+| **Country** | The countries with the most visitors. |+| **Visitor activity** | Visitors or views plotted by day. |++Visitor identifiers are derived from the day, site, IP address, and user agent, then stored as a hash. Docs7 does not store the raw IP address. Because the identifier changes daily, the same browser can count again on a later day.++## Searches++The search report shows what readers type into the site's search box, how many times each query was used, and how many visitors searched for it.++Search runs as the reader types. Docs7 folds short prefixes into the completed query when the same visitor continues typing within ten seconds. For example, `rate`, `rate l`, and `rate limit` count as `rate limit` instead of three separate searches.++A **No results** label means every recorded search for that term returned no result. Use these terms to find missing pages, missing vocabulary, or titles that do not match the words readers use.++## Assistant questions++This report covers questions visitors send to the documentation assistant. It shows the total number of questions and conversations.++Questions are grouped into topics once per day. Expand a topic to see recent examples. Questions that have not been grouped yet appear under **Uncategorized**.++## Top pages and referrers++**Top pages** ranks documentation paths by visitors and views. **Referrers** shows where visitors came from. Requests without a referrer are grouped under **Direct**.++Use Top pages to see what readers rely on, then compare it with Searches and Assistant questions. A frequently requested topic with no strong destination page is a concrete documentation gap.++<Note>+AI crawler traffic is reported separately under [AI Visibility](/docs7/ai-visibility).+</Note>diff --git a/docs/docs7/builds.mdx b/docs/docs7/builds.mdxnew file mode 100644index 00000000..54595f1d--- /dev/null+++ b/docs/docs7/builds.mdx@@ -0,0 +1,93 @@+---+title: Builds+description: Configure production builds, previews, and local builds+---++Connect a GitHub repository once. Docs7 then reads the configured documentation folder whenever it builds that site.++The folder must contain `docs.json` or `mint.json`. It can also contain MDX pages, assets, snippets, OpenAPI files, and any other files referenced by the documentation.++<Frame caption="The Builds view records the status, branch, commit, and start time for each deployment.">+ <img+ src="/images/docs7/dashboard/builds.jpg"+ alt="Docs7 Builds dashboard with successful deployments across recent documentation commits"+ />+</Frame>++## Build settings++Open **Docs7**, choose a site, then open **Settings**.++| Setting | What it controls |+| --- | --- |+| **Slug** | The site's `*.docs7.io` hostname. Changing it moves the production site and its previews. |+| **Production branch** | The branch used for production builds. Leave it on the GitHub default branch, or select another branch. |+| **Docs path** | The repository-relative folder that contains `docs.json` or `mint.json`. Use `.` for the repository root. |++Branch and docs path changes take effect on the next deployment. You can also serve the site from its own custom domain or from a path such as `example.com/docs`.++## Production builds++Docs7 starts a production build in three cases:++1. You publish a site for the first time.+2. You push a commit to the production branch.+3. You click **Redeploy** in Docs7.++For each build, Docs7 resolves the exact commit, checks out the repository, and reads the configured docs path. It then renders the pages, builds the search index, runs documentation health checks, and publishes the completed release.++Publication happens only after the release is ready. If a build fails, the previous successful release stays live.++<Note>+A push to another branch does not create a preview by itself. Preview builds come from pull requests or a manual preview deployment.+</Note>++## Pull request previews++Docs7 creates or updates a preview when a pull request:++- comes from a branch in the connected repository+- uses a head branch other than the site's production branch+- changes a file inside the configured docs path+- is opened, reopened, or receives a new commit++Closing or merging the pull request removes its preview. Pull requests from forks do not get a preview because Docs7 cannot check out the fork branch through the connected repository.++Preview responses include `X-Robots-Tag: noindex`, so temporary URLs do not compete with the production site in search results.++You can also create a preview for a selected branch manually. Open a preview build to redeploy it or delete its live preview.++## Inspect a build++Open **Builds**, then select a row. Each build records its branch, commit, trigger, status, and commit message.++The detail view contains:++- **Log** for renderer and deployment output+- **Files changed** for pull request builds+- **Health** for page errors, broken internal links, unknown components, source warnings, and deployment failures++Fixable issues from the latest production build also appear in the [Agent work queue](/docs7/agent#context7-agent).++## Build locally++Use the CLI before you push:++```bash+docs7 dev ./docs+```++The development server watches the docs folder and reloads changes. Common options are:++```bash+docs7 dev ./docs --port 4000+docs7 dev ./docs --host 0.0.0.0+```++Use `--port` to change the port and `--host` to bind another address. The first run downloads the Docs7 renderer and caches it for later previews.++The public CLI previews documentation but does not publish it. Push the repository or click **Redeploy** to start a hosted build.++<Warning>+A local preview executes trusted MDX with your local user permissions. Do not run it against a documentation source you do not trust.+</Warning>diff --git a/docs/docs7/components/accordions.mdx b/docs/docs7/components/accordions.mdxnew file mode 100644index 00000000..98e8e630--- /dev/null+++ b/docs/docs7/components/accordions.mdx@@ -0,0 +1,32 @@+---+title: Accordions+description: Hide details until the reader opens them+---++Use `<AccordionGroup>` when several accordions belong together.++## Usage++```mdx+<AccordionGroup>+ <Accordion title="Does Docs7 support MDX?">+ Yes.+ </Accordion>+ <Accordion title="Is this open by default?" defaultOpen>+ Yes.+ </Accordion>+</AccordionGroup>+```++`<Accordion>` also accepts `description`, `icon`, and `iconType`.++## Example++<AccordionGroup>+ <Accordion title="Does Docs7 support MDX?">+ Yes.+ </Accordion>+ <Accordion title="Is this open by default?" defaultOpen>+ Yes.+ </Accordion>+</AccordionGroup>diff --git a/docs/docs7/components/badge.mdx b/docs/docs7/components/badge.mdxnew file mode 100644index 00000000..8cf5efa6--- /dev/null+++ b/docs/docs7/components/badge.mdx@@ -0,0 +1,20 @@+---+title: Badges+description: Add a small status or version label+---++Use `<Badge>` for a short label.++## Usage++```mdx+<Badge color="green">Stable</Badge>+<Badge color="purple" shape="pill" stroke>Beta</Badge>+```++Useful props are `color`, `size`, `shape`, `icon`, `stroke`, and `disabled`.++## Example++<Badge color="green">Stable</Badge>{" "}+<Badge color="purple" shape="pill" stroke>Beta</Badge>diff --git a/docs/docs7/components/callouts.mdx b/docs/docs7/components/callouts.mdxnew file mode 100644index 00000000..17414a3f--- /dev/null+++ b/docs/docs7/components/callouts.mdx@@ -0,0 +1,36 @@+---+title: Callouts+description: Highlight notes, warnings, and other important information+---++Use a named callout for short information that should stand out. `<Success>` is an alias for `<Check>`.++## Usage++```mdx+<Note>Useful context.</Note>+<Info>Neutral information.</Info>+<Tip>A helpful suggestion.</Tip>+<Warning>Something needs attention.</Warning>+<Check>Something worked.</Check>+<Danger>A risky action.</Danger>++<Callout icon="sparkles" color="#8B5CF6">+ A custom callout.+</Callout>+```++Named callouts also accept `emoji` and `type`. `<Callout>` accepts `icon`, `iconType`, and `color`.++## Example++<Note>Useful context.</Note>+<Info>Neutral information.</Info>+<Tip>A helpful suggestion.</Tip>+<Warning>Something needs attention.</Warning>+<Check>Something worked.</Check>+<Danger>A risky action.</Danger>++<Callout icon="sparkles" color="#8B5CF6">+ A custom callout.+</Callout>diff --git a/docs/docs7/components/cards.mdx b/docs/docs7/components/cards.mdxnew file mode 100644index 00000000..662f438b--- /dev/null+++ b/docs/docs7/components/cards.mdx@@ -0,0 +1,22 @@+---+title: Cards+description: Group related content and link to another page+---++`<Card>` can be static or clickable.++## Usage++```mdx+<Card title="Quickstart" icon="rocket" href="/docs7/quickstart">+ Get running in a few minutes.+</Card>+```++Useful props are `title`, `href`, `icon`, `img`, `cta`, `horizontal`, and `arrow`. Use [Columns](/docs7/components/columns) for a card grid.++## Example++<Card title="Quickstart" icon="rocket" href="/docs7/quickstart">+ Get running in a few minutes.+</Card>diff --git a/docs/docs7/components/code-groups.mdx b/docs/docs7/components/code-groups.mdxnew file mode 100644index 00000000..1cf7032f--- /dev/null+++ b/docs/docs7/components/code-groups.mdx@@ -0,0 +1,42 @@+---+title: Code groups+description: Show code examples in tabs+---++Place titled code fences inside `<CodeGroup>`. Use `<CodeBlock>` when code comes from an MDX component.++## Usage++````mdx+<CodeGroup>+```js JavaScript+console.log("hello")+```++```py Python+print("hello")+```+</CodeGroup>++<CodeBlock language="ts" filename="index.ts" lines>+ {"const ready = true"}+</CodeBlock>+````++`<CodeBlock>` also accepts `icon`, `highlight`, `focus`, `wrap`, and `expandable`.++## Example++<CodeGroup>+```js JavaScript+console.log("hello")+```++```py Python+print("hello")+```+</CodeGroup>++<CodeBlock language="ts" filename="index.ts" lines>+ {"const ready = true"}+</CodeBlock>diff --git a/docs/docs7/components/color.mdx b/docs/docs7/components/color.mdxnew file mode 100644index 00000000..910247d3--- /dev/null+++ b/docs/docs7/components/color.mdx@@ -0,0 +1,30 @@+---+title: Color+description: Show click-to-copy color swatches+---++Add one `<Color.Item>` for each swatch.++## Usage++```mdx+<Color>+ <Color.Item name="Primary" value="#10B981" />+ <Color.Item+ name="Surface"+ value={{ light: "#FFFFFF", dark: "#18181B" }}+ />+</Color>+```++Use `variant="table"` with `<Color.Row title="...">` to group a larger palette.++## Example++<Color>+ <Color.Item name="Primary" value="#10B981" />+ <Color.Item+ name="Surface"+ value={{ light: "#FFFFFF", dark: "#18181B" }}+ />+</Color>diff --git a/docs/docs7/components/columns.mdx b/docs/docs7/components/columns.mdxnew file mode 100644index 00000000..a57ef6f5--- /dev/null+++ b/docs/docs7/components/columns.mdx@@ -0,0 +1,24 @@+---+title: Columns+description: Arrange content in a responsive grid+---++Set `cols` from 1 to 4. `<CardGroup>` is the legacy name for `<Columns>`.++## Usage++```mdx+<Columns cols={2}>+ <Column>First column.</Column>+ <Column>Second column.</Column>+</Columns>+```++Cards do not need a `<Column>` wrapper.++## Example++<Columns cols={2}>+ <Column>First column.</Column>+ <Column>Second column.</Column>+</Columns>diff --git a/docs/docs7/components/examples.mdx b/docs/docs7/components/examples.mdxnew file mode 100644index 00000000..e5ae7658--- /dev/null+++ b/docs/docs7/components/examples.mdx@@ -0,0 +1,39 @@+---+title: Request and response examples+sidebarTitle: Examples+description: Pin API examples beside the page content+---++Wrap one or more code fences in `<RequestExample>` or `<ResponseExample>`.++## Usage++````mdx+<RequestExample>+```bash cURL+curl https://api.example.com/users+```+</RequestExample>++<ResponseExample>+```json 200+{"items": []}+```+</ResponseExample>+````++## Example++See the example in the right sidebar. On mobile, it appears inline below.++<RequestExample>+```bash cURL+curl https://api.example.com/users+```+</RequestExample>++<ResponseExample>+```json 200+{"items": []}+```+</ResponseExample>diff --git a/docs/docs7/components/expandables.mdx b/docs/docs7/components/expandables.mdxnew file mode 100644index 00000000..14d30652--- /dev/null+++ b/docs/docs7/components/expandables.mdx@@ -0,0 +1,30 @@+---+title: Expandables+description: Document nested object properties+---++Place `<Expandable>` inside a field.++## Usage++```mdx+<ResponseField name="user" type="object">+ A user record.+ <Expandable title="properties" defaultOpen>+ <ResponseField name="id" type="string" required />+ <ResponseField name="name" type="string" />+ </Expandable>+</ResponseField>+```++The default title is `properties`.++## Example++<ResponseField name="user" type="object">+ A user record.+ <Expandable title="properties" defaultOpen>+ <ResponseField name="id" type="string" required />+ <ResponseField name="name" type="string" />+ </Expandable>+</ResponseField>diff --git a/docs/docs7/components/fields.mdx b/docs/docs7/components/fields.mdxnew file mode 100644index 00000000..fe2a48ca--- /dev/null+++ b/docs/docs7/components/fields.mdx@@ -0,0 +1,30 @@+---+title: Fields+description: Document request parameters and response fields+---++Use one of `query`, `path`, `body`, or `header` as the name of a request parameter.++## Usage++```mdx+<ParamField query="limit" type="number" default="20">+ Maximum results to return.+</ParamField>++<ResponseField name="items" type="object[]" required>+ The returned items.+</ResponseField>+```++Both components accept `type`, `required`, `deprecated`, and `default`.++## Example++<ParamField query="limit" type="number" default="20">+ Maximum results to return.+</ParamField>++<ResponseField name="items" type="object[]" required>+ The returned items.+</ResponseField>diff --git a/docs/docs7/components/frames.mdx b/docs/docs7/components/frames.mdxnew file mode 100644index 00000000..a706a74e--- /dev/null+++ b/docs/docs7/components/frames.mdx@@ -0,0 +1,26 @@+---+title: Frames+description: Present images, videos, and embeds with an optional caption+---++Wrap visual content in `<Frame>`.++## Usage++```mdx+<Frame caption="A framed preview">+ <div style={{ padding: "3rem", textAlign: "center" }}>+ Screenshot or video+ </div>+</Frame>+```++Use `width` to constrain the frame or `fullWidth` to fill the content column.++## Example++<Frame caption="A framed preview">+ <div style={{ padding: "3rem", textAlign: "center" }}>+ Screenshot or video+ </div>+</Frame>diff --git a/docs/docs7/components/github.mdx b/docs/docs7/components/github.mdxnew file mode 100644index 00000000..0c6c0cfb--- /dev/null+++ b/docs/docs7/components/github.mdx@@ -0,0 +1,18 @@+---+title: GitHub+description: Show a GitHub repository card+---++Pass the repository as `owner/name`.++## Usage++```mdx+<GitHub.Repo repo="upstash/context7" />+```++Use `variant="flat"` for a simpler card surface. The default is `inset`.++## Example++<GitHub.Repo repo="upstash/context7" />diff --git a/docs/docs7/components/icons.mdx b/docs/docs7/components/icons.mdxnew file mode 100644index 00000000..18db6a18--- /dev/null+++ b/docs/docs7/components/icons.mdx@@ -0,0 +1,19 @@+---+title: Icons+description: Add an icon inline with text+---++Icons can come from the active icon library or a local SVG.++## Usage++```mdx+<Icon icon="book" color="#10B981" size={24} />+<Icon icon="/logo/mark.svg" size={24} />+```++Use `iconType` to select an icon style. The active library comes from `icons.library` in `docs.json`.++## Example++<Icon icon="book" color="#10B981" size={24} />diff --git a/docs/docs7/components/latex.mdx b/docs/docs7/components/latex.mdxnew file mode 100644index 00000000..ee537048--- /dev/null+++ b/docs/docs7/components/latex.mdx@@ -0,0 +1,26 @@+---+title: LaTeX+description: Add mathematical notation to a page+---++Use dollar signs in Markdown or the `<Latex>` component in MDX.++## Usage++```md+Inline: $E = mc^2$++$$+\frac{1}{2}+$$+```++```mdx+<Latex>x^2 + y^2</Latex>+```++## Example++Inline math: <Latex>E = mc^2</Latex>++<Latex>\frac{1}{2}</Latex>diff --git a/docs/docs7/components/mermaid.mdx b/docs/docs7/components/mermaid.mdxnew file mode 100644index 00000000..eb190be3--- /dev/null+++ b/docs/docs7/components/mermaid.mdx@@ -0,0 +1,24 @@+---+title: Mermaid+description: Create diagrams from a code fence+---++Use the `mermaid` language on a fenced code block.++## Usage++````md+```mermaid+graph LR+ A[Write] --> B[Preview] --> C[Publish]+```+````++Docs7 keeps the source readable in Markdown exports.++## Example++```mermaid+graph LR+ A[Write] --> B[Preview] --> C[Publish]+```diff --git a/docs/docs7/components/panel.mdx b/docs/docs7/components/panel.mdxnew file mode 100644index 00000000..c6249e4d--- /dev/null+++ b/docs/docs7/components/panel.mdx@@ -0,0 +1,28 @@+---+title: Panel+description: Place custom content in the right column+---++A top-level `<Panel>` replaces the table of contents for that page.++## Usage++```mdx+<Panel>+ <Card title="Need help?" href="/support">+ Contact the support team.+ </Card>+</Panel>+```++A page can have one panel. API examples use the same right column.++## Example++See the panel in the right sidebar. On mobile, the panel is hidden.++<Panel>+ <Card title="Need help?" href="/docs7/quickstart">+ Open the Docs7 quickstart.+ </Card>+</Panel>diff --git a/docs/docs7/components/prompt.mdx b/docs/docs7/components/prompt.mdxnew file mode 100644index 00000000..de9f150a--- /dev/null+++ b/docs/docs7/components/prompt.mdx@@ -0,0 +1,22 @@+---+title: Prompt+description: Present a prompt that readers can copy or open in Cursor+---++The default action is `copy`.++## Usage++```mdx+<Prompt description="Copy this prompt" actions={["copy", "cursor"]}>+ Explain this API in one paragraph.+</Prompt>+```++Set `actions={[]}` to hide the actions. `icon` and `iconType` are optional.++## Example++<Prompt description="Copy this prompt" actions={["copy", "cursor"]}>+ Explain this API in one paragraph.+</Prompt>diff --git a/docs/docs7/components/react-components.mdx b/docs/docs7/components/react-components.mdxnew file mode 100644index 00000000..deadb977--- /dev/null+++ b/docs/docs7/components/react-components.mdx@@ -0,0 +1,26 @@+---+title: React components+description: Define a small custom component in MDX+---++Define the component with an ESM export, then use it in the page.++## Usage++```mdx+export const Status = ({ children }) => (+ <Badge color="green">{children}</Badge>+)++The API is <Status>ready</Status>.+```++Keep custom components small. Use a shared MDX or JSX snippet when several pages need the same component.++## Example++export const ExampleStatus = ({ children }) => (+ <Badge color="green">{children}</Badge>+)++The API is <ExampleStatus>ready</ExampleStatus>.diff --git a/docs/docs7/components/steps.mdx b/docs/docs7/components/steps.mdxnew file mode 100644index 00000000..5fce8312--- /dev/null+++ b/docs/docs7/components/steps.mdx@@ -0,0 +1,24 @@+---+title: Steps+description: Write a numbered procedure+---++Use `<Steps>` for a short procedure.++## Usage++```mdx+<Steps>+ <Step title="Install">Install the package.</Step>+ <Step title="Run">Start the server.</Step>+</Steps>+```++`<Step>` also accepts `icon` and `stepNumber`. Set `titleSize="h2"` or `titleSize="h3"` to add step titles to the table of contents.++## Example++<Steps>+ <Step title="Install">Install the package.</Step>+ <Step title="Run">Start the server.</Step>+</Steps>diff --git a/docs/docs7/components/tabs.mdx b/docs/docs7/components/tabs.mdxnew file mode 100644index 00000000..92ff753e--- /dev/null+++ b/docs/docs7/components/tabs.mdx@@ -0,0 +1,24 @@+---+title: Tabs+description: Switch between related blocks of content+---++Each `<Tab>` needs a `title`.++## Usage++```mdx+<Tabs>+ <Tab title="npm">npm install my-package</Tab>+ <Tab title="pnpm">pnpm add my-package</Tab>+</Tabs>+```++A tab can also have `icon` and `iconType` props.++## Example++<Tabs>+ <Tab title="npm">npm install my-package</Tab>+ <Tab title="pnpm">pnpm add my-package</Tab>+</Tabs>diff --git a/docs/docs7/components/tiles.mdx b/docs/docs7/components/tiles.mdxnew file mode 100644index 00000000..bce802f7--- /dev/null+++ b/docs/docs7/components/tiles.mdx@@ -0,0 +1,22 @@+---+title: Tiles+description: Create a link with a large visual preview+---++`<Tile>` needs an `href`. Its children appear in the preview area.++## Usage++```mdx+<Tile href="/docs7/quickstart" title="Quickstart" description="Preview and publish your docs">+ <Icon icon="book" size={48} />+</Tile>+```++Place tiles inside [Columns](/docs7/components/columns) to create a grid.++## Example++<Tile href="/docs7/quickstart" title="Quickstart" description="Preview and publish your docs">+ <Icon icon="book" size={48} />+</Tile>diff --git a/docs/docs7/components/tooltips.mdx b/docs/docs7/components/tooltips.mdxnew file mode 100644index 00000000..c59bb1b0--- /dev/null+++ b/docs/docs7/components/tooltips.mdx@@ -0,0 +1,18 @@+---+title: Tooltips+description: Explain a word or action on hover+---++Wrap the text that should trigger the tooltip.++## Usage++```mdx+Read the <Tooltip tip="A short explanation">API reference</Tooltip>.+```++Add `cta` and `href` when the tooltip should include a link.++## Example++Read the <Tooltip tip="A short explanation">API reference</Tooltip>.diff --git a/docs/docs7/components/tree.mdx b/docs/docs7/components/tree.mdxnew file mode 100644index 00000000..7cf133c0--- /dev/null+++ b/docs/docs7/components/tree.mdx@@ -0,0 +1,28 @@+---+title: Tree+description: Show a file and folder structure+---++Use nested folder and file components.++## Usage++```mdx+<Tree>+ <Tree.Folder name="src" defaultOpen>+ <Tree.File name="index.ts" highlight />+ </Tree.Folder>+ <Tree.File name="package.json" />+</Tree>+```++Folders accept `defaultOpen`, `openable`, and `highlight`. `<FileTree>` is an alias for `<Tree>`.++## Example++<Tree>+ <Tree.Folder name="src" defaultOpen>+ <Tree.File name="index.ts" highlight />+ </Tree.Folder>+ <Tree.File name="package.json" />+</Tree>diff --git a/docs/docs7/components/updates.mdx b/docs/docs7/components/updates.mdxnew file mode 100644index 00000000..5814a5e5--- /dev/null+++ b/docs/docs7/components/updates.mdx@@ -0,0 +1,22 @@+---+title: Updates+description: Build a changelog from dated entries+---++`<Update>` requires a `label`. Use ISO dates when the page also publishes an RSS feed.++## Usage++```mdx+<Update label="2026-08-24" tags={["New"]}>+ Added branch previews.+</Update>+```++`description` adds a short label beside the date. Readers can filter entries by `tags`.++## Example++<Update label="2026-08-24" tags={["New"]}>+ Added branch previews.+</Update>diff --git a/docs/docs7/components/view.mdx b/docs/docs7/components/view.mdxnew file mode 100644index 00000000..cc2f45e7--- /dev/null+++ b/docs/docs7/components/view.mdx@@ -0,0 +1,30 @@+---+title: View+description: Let readers switch between versions of page content+---++Sibling `<View>` components form one selector.++## Usage++```mdx+<View title="React" icon="react">+ React instructions.+</View>++<View title="Vue" icon="vuejs">+ Vue instructions.+</View>+```++`title` is required. `icon` and `iconType` are optional.++## Example++<View title="React" icon="react">+ React instructions.+</View>++<View title="Vue" icon="vuejs">+ Vue instructions.+</View>diff --git a/docs/docs7/components/visibility.mdx b/docs/docs7/components/visibility.mdxnew file mode 100644index 00000000..a0bf5ea2--- /dev/null+++ b/docs/docs7/components/visibility.mdx@@ -0,0 +1,28 @@+---+title: Visibility+description: Show different content to people and AI tools+---++Use `for="humans"` or `for="agents"`.++## Usage++```mdx+<Visibility for="humans">+ This appears on the website.+</Visibility>++<Visibility for="agents">+ This appears in the Markdown export.+</Visibility>+```++## Example++<Visibility for="humans">+ This content is visible on the website.+</Visibility>++<Visibility for="agents">+ This content is visible only in the Markdown export.+</Visibility>diff --git a/docs/docs7/configuration.mdx b/docs/docs7/configuration.mdxnew file mode 100644index 00000000..f08ea183--- /dev/null+++ b/docs/docs7/configuration.mdx@@ -0,0 +1,100 @@+---+title: Docs7 configuration+description: Configure Docs7-only fields in docs.json+---++Docs7 supports the `docs.json` format that was established by Mintlify. We also support options beyond this spec to make your documentation easier to navigate and to create custom content groups.++++## Group products++Product groups add a product switcher to the sidebar. A reader picks a product, and the sidebar shows only the pages for that product.++<Frame caption="Before a reader picks a product, the sidebar lists the tab's own pages and every product group.">+ <img+ src="/images/docs7/product-groups.png"+ alt="Docs7 sidebar showing the Products and Utility Tools product groups"+ />+</Frame>++<Frame caption="After picking Redis, the sidebar shows only Redis pages. The dropdown at the top switches products.">+ <img+ src="/images/docs7/product-groups-selected.png"+ alt="Docs7 sidebar with Redis selected in the product switcher"+ />+</Frame>++To set this up, add a `productGroups` list to one tab. That tab shows the product switcher. The tab's own pages fill the sidebar until the reader picks a product. Each product then lists its own pages. If your docs have several versions or languages, add the list to one tab in each of them.++```json docs.json+{+ "navigation": {+ "tabs": [+ {+ "tab": "Documentation",+ "pages": ["index"],+ "productGroups": [+ {+ "group": "Products",+ "products": [+ {+ "product": "Redis",+ "icon": "/images/redis.svg",+ "description": "Serverless Redis",+ "pages": ["redis/overview", "redis/get-started"]+ }+ ]+ },+ {+ "group": "Utility",+ "products": [+ {+ "product": "Rate Limit",+ "pages": ["ratelimit/overview", "ratelimit/get-started"]+ }+ ]+ }+ ]+ },+ {+ "tab": "API Reference",+ "pages": ["api/introduction"]+ }+ ]+ }+}+```++In this example:++- The Documentation tab shows the product switcher. Until the reader picks a product, the sidebar shows the index page.+- Redis and Rate Limit are the two products. Each one lists the pages that appear when it is selected.+- The API Reference tab is a normal tab and does not use product groups.++Rules:++- Each product needs either a list of pages or a list of groups, not both.+- That list must have at least one entry.+- Inside one tab, product names must be unique, and group names must be unique.++If you do not add product groups, Docs7 uses your regular navigation.++## Enable sidebar filtering++Set `filterSidebar` to `true` to add a filter above the sidebar. Readers can press `/` to focus it.++```json docs.json+{+ "filterSidebar": true+}+```++<Frame caption="The filter box sits above the sidebar. Typing in it narrows the sidebar to matching pages.">+ <img+ src="/images/docs7/filter-sidebar.png"+ alt="Docs7 sidebar with the filter box above the page list"+ />+</Frame>++The default value is `false`.diff --git a/docs/docs7/migrate-from-mintlify.mdx b/docs/docs7/migrate-from-mintlify.mdxnew file mode 100644index 00000000..b33b943a--- /dev/null+++ b/docs/docs7/migrate-from-mintlify.mdx@@ -0,0 +1,45 @@+---+title: Migrate from Mintlify+description: Move an existing Mintlify project to Docs7+---++Docs7 reads the Mintlify content format. Keep your `docs.json` or `mint.json`, MDX pages, assets, snippets, redirects, and OpenAPI files.++## 1. Preview the project++From the folder that contains `docs.json` or `mint.json`, run:++```bash+npm install -g @upstash/docs7+docs7 dev+```++Open [http://localhost:3333](http://localhost:3333) to see your documentation site.++## 2. Connect the repository++In your Context7 teamspace:++1. Open **Docs7** and click **Add New Site**.+2. Connect GitHub if needed.+3. Choose the repository and production branch.+4. Set **Docs path** to the folder that contains `docs.json`. Use `.` when it is at the repository root.+5. Publish the site.++<Frame>+<img src="/images/docs7/publish-a-site.png" alt="Publish a site in Docs7"></img>+</Frame>++Review the build log and compare the new site with the current Mintlify site. Your Mintlify deployment can stay online while you test Docs7.++## 3. Move the domain++If you use a custom domain, add it to the Docs7 site before changing traffic. Docs7 will show the DNS records it needs.++Switch the routing record only after the domain is ready and the Docs7 site looks correct.++<Frame>+<img src="/images/docs7/custom-domain.png" alt="Configure a custom domain in Docs7"></img>+</Frame>++After the switch, remove the Mintlify GitHub integration so one push does not deploy to both services.diff --git a/docs/docs7/overview.mdx b/docs/docs7/overview.mdxnew file mode 100644index 00000000..44bf843d--- /dev/null+++ b/docs/docs7/overview.mdx@@ -0,0 +1,36 @@+---+title: Intro+description: A documentation platform built for the way agents read, search, and decide+---++Docs7 turns your existing GitHub repository into fast, beautiful documentation for people and clean, structured context for agents.++## ❌ Without Docs7++Most documentation platforms make agents work around pages built for humans:++- ❌ No insights into what agents search for, or which questions returned no answer+- ❌ Agents waste tokens on navigation and reading layouts+- ❌ Agents hallucinate non-existent documentation links++## ✅ With Docs7++Docs7 is the best way to serve documentation to agents:++- ✅ Distribute your docs to 100,000+ active Context7 users+- ✅ Deep insights into AI crawler traffic, searches, and assistant questions+- ✅ Prevents hallucinations by guiding agents to the right page++## Start here++<Columns cols={3}>+ <Card title="Quickstart" href="/docs7/quickstart">+ Preview a project with the CLI, then publish it.+ </Card>+ <Card title="Migration guide" href="/docs7/migrate-from-mintlify">+ Move an existing site without rewriting it.+ </Card>+ <Card title="Components" href="/docs7/components/callouts">+ Use the built-in MDX component library.+ </Card>+</Columns>diff --git a/docs/docs7/quickstart.mdx b/docs/docs7/quickstart.mdxnew file mode 100644index 00000000..fef34892--- /dev/null+++ b/docs/docs7/quickstart.mdx@@ -0,0 +1,83 @@+---+title: Quickstart+description: Preview and publish a Docs7 site+---++## 1. Add your docs++In a new folder, create a `docs.json` file:++<Tip>+You can skip this step if your project already has a `docs.json` or `mint.json` file.+</Tip>++```json docs.json+{+ "name": "My docs",+ "navigation": {+ "groups": [+ {+ "group": "Guide",+ "pages": ["index"]+ }+ ]+ }+}+```++Then add the first page:++```mdx index.mdx+---+title: Introduction+description: Welcome to my docs+---++Hello, world.+```++## 2. Install the CLI++Install the package globally:++```bash+npm install -g @upstash/docs7+```++This adds the `docs7` command to your terminal.++## 3. Start the dev server++Run this from the folder that contains `docs.json`:++```bash+docs7 dev+```++Open [http://localhost:3333](http://localhost:3333). The page reloads when you edit a file.++The first run downloads the renderer and caches it for later. You can also pass a project folder or use another port:++```bash+docs7 dev ./docs --port 4000+```++<Note>+ You can also run the CLI without installing it: `npx @upstash/docs7 dev`.+</Note>++## 4. Publish++1. Push the project to GitHub.+2. Open the **Docs7** tab in your Context7 teamspace.+3. Click **Add New Site** and choose the repository.+4. Set the production branch and the folder that contains `docs.json`.+5. Click **Publish Site**.++<Frame>+<img src="/images/docs7/publish-a-site.png" alt="Publish a site in Docs7"></img>+</Frame>++Every push to the production branch creates a new deployment. Pull requests get a preview site.++Next, learn [how production and preview builds work](/docs7/builds) or browse the [MDX components](/docs7/components/callouts).diff --git a/docs/docs7/seo.mdx b/docs/docs7/seo.mdxnew file mode 100644index 00000000..36a674bf--- /dev/null+++ b/docs/docs7/seo.mdx@@ -0,0 +1,79 @@+---+title: SEO+description: Control indexing, metadata, sitemaps, and structured data+---++Docs7 automatically generates search metadata for your website.++## Defaults++Every indexable page receives:++- a canonical URL based on the deployed site URL+- a meta description from frontmatter or the page's opening text+- Open Graph and Twitter metadata with a generated preview image+- JSON-LD for the organization, website, page, breadcrumbs, and article+- a sitemap entry with the last modification date when Git history provides one++Docs7 also generates `robots.txt` and `sitemap.xml`. The generated robots file sets `Content-Signal: ai-train=yes, search=yes, ai-input=yes`.++Preview deployments are automatically excluded from indexing.++API pages use `APIReference` structured data. Other documentation pages use `Article` and `TechArticle` to make it easy for agents to parse your content.+++## Configure site metadata++Set shared SEO values in `docs.json`:++```json docs.json+{+ "name": "Acme Docs",+ "seo": {+ "indexing": "navigable",+ "trailingSlash": false,+ "metatags": {+ "canonical": "https://docs.acme.com",+ "robots": "index, follow",+ "og:site_name": "Acme Docs"+ },+ "organization": {+ "name": "Acme",+ "url": "https://acme.com",+ "sameAs": ["https://github.com/acme"]+ }+ }+}+```++`seo.indexing` accepts:++- `navigable`, the default, which indexes pages listed in navigation and excludes hidden or unlisted pages+- `all`, which indexes every routable page unless the page sets `noindex: true`++A hidden navigation group can opt back in with `searchable: true`.++<Note>+If the site is mounted at a path such as `example.com/docs`, the parent website's root `robots.txt` controls crawler policy. Add `Sitemap: https://example.com/docs/sitemap.xml` there. Crawlers do not treat `/docs/robots.txt` as the origin's robots file.+</Note>+++Set page-specific values in frontmatter:++```yaml+---+title: Create an API key+description: Create and rotate API keys for the Acme API+keywords:+ - API key+ - authentication+image: /images/api-key-card.png+canonical: https://docs.acme.com/auth/api-keys+---+```++Use `noindex: true` to keep a routable page out of search results. You can also set a `robots` value or `og:*`, `twitter:*`, and `article:*` fields directly in frontmatter.++<Note>+A `robots.txt` or `sitemap.xml` file at the docs root replaces the generated file. Keep the generated version unless you need full control.+</Note>diff --git a/docs/images/docs7/custom-domain.png b/docs/images/docs7/custom-domain.pngnew file mode 100644index 00000000..6c25e0f2Binary files /dev/null and b/docs/images/docs7/custom-domain.png differdiff --git a/docs/images/docs7/dashboard/agent-pr-review.jpg b/docs/images/docs7/dashboard/agent-pr-review.jpgnew file mode 100644index 00000000..e50a66ccBinary files /dev/null and b/docs/images/docs7/dashboard/agent-pr-review.jpg differdiff --git a/docs/images/docs7/dashboard/agent.jpg b/docs/images/docs7/dashboard/agent.jpgnew file mode 100644index 00000000..4cfebb39Binary files /dev/null and b/docs/images/docs7/dashboard/agent.jpg differdiff --git a/docs/images/docs7/dashboard/ai-visibility.jpg b/docs/images/docs7/dashboard/ai-visibility.jpgnew file mode 100644index 00000000..93658feaBinary files /dev/null and b/docs/images/docs7/dashboard/ai-visibility.jpg differdiff --git a/docs/images/docs7/dashboard/analytics.jpg b/docs/images/docs7/dashboard/analytics.jpgnew file mode 100644index 00000000..e4208a9dBinary files /dev/null and b/docs/images/docs7/dashboard/analytics.jpg differdiff --git a/docs/images/docs7/dashboard/builds.jpg b/docs/images/docs7/dashboard/builds.jpgnew file mode 100644index 00000000..e5bdc2ecBinary files /dev/null and b/docs/images/docs7/dashboard/builds.jpg differdiff --git a/docs/images/docs7/filter-sidebar.png b/docs/images/docs7/filter-sidebar.pngnew file mode 100644index 00000000..56821ecaBinary files /dev/null and b/docs/images/docs7/filter-sidebar.png differdiff --git a/docs/images/docs7/product-groups-selected.png b/docs/images/docs7/product-groups-selected.pngnew file mode 100644index 00000000..a0b20f09Binary files /dev/null and b/docs/images/docs7/product-groups-selected.png differdiff --git a/docs/images/docs7/product-groups.png b/docs/images/docs7/product-groups.pngnew file mode 100644index 00000000..b14e8d83Binary files /dev/null and b/docs/images/docs7/product-groups.png differdiff --git a/docs/images/docs7/publish-a-site.png b/docs/images/docs7/publish-a-site.pngnew file mode 100644index 00000000..e70f38aeBinary files /dev/null and b/docs/images/docs7/publish-a-site.png differdiff --git a/docs/images/docs7/url-suggestions.png b/docs/images/docs7/url-suggestions.pngnew file mode 100644index 00000000..c6aa90c7Binary files /dev/null and b/docs/images/docs7/url-suggestions.png differ