Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .env.docs-cloud.example
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# Docs Cloud
# Create this key in Docs Cloud Settings -> API Keys.
# Store the real value in production env, CI secrets, or your hosting provider.
DOCS_CLOUD_API_KEY=
25 changes: 25 additions & 0 deletions DOCS_CLOUD_SETUP.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Docs Cloud Setup

This PR connects the existing docs app to Docs Cloud without replacing the docs content.

## What this PR adds

- `docs.json` configures the docs root, draft PR publishing, and analytics.
- `.env.docs-cloud.example` documents the production environment variable the docs app needs.
- Analytics is enabled in `docs.json`; keep it enabled unless the project intentionally opts out.

## Finish the setup

1. Open Docs Cloud and go to Settings -> API Keys.
2. Create an API key with the default project, docs, and jobs scopes.
3. Add the key to production as `DOCS_CLOUD_API_KEY`.
4. If the host uses files, put the value in `.env.production`. If it uses managed secrets, add the same variable there instead.
5. Do not commit the real key. Keep `.env.docs-cloud.example` as the checked-in reference.

## Config review

- Docs root: `apps/docs`
- Publish base branch: `main`
- Publish mode: `draft-pr`
- Preview deploys: not requested by this setup PR
- Analytics: enabled
25 changes: 25 additions & 0 deletions docs.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
{
"$schema": "https://docs.farming-labs.dev/schema/docs.json",
"version": 1,
"docs": {
"mode": "frameworkless",
"runtime": "nextjs",
"root": "apps/docs"
},
"cloud": {
"apiKey": {
"env": "DOCS_CLOUD_API_KEY"
},
"preview": {
"enabled": false
},
"publish": {
"mode": "draft-pr",
"baseBranch": "main"
},
"analytics": {
"enabled": true,
"includeInputs": false
}
}
}
Loading