Skip to content

feat: add docs app#279

Merged
luxass merged 10 commits intomainfrom
docs-app
Oct 1, 2025
Merged

feat: add docs app#279
luxass merged 10 commits intomainfrom
docs-app

Conversation

@luxass
Copy link
Copy Markdown
Member

@luxass luxass commented Sep 29, 2025

🔗 Linked issue

📚 Description

This PR initializes the docs application. A separate PR will be made to update the docs!

Summary by CodeRabbit

  • New Features
    • Introduces a new deployable Documentation app with homepage and navigation.
  • Documentation
    • Adds comprehensive content: Getting Started (Introduction, Installation, Project Structure, Studio, Migration) and Essentials (Markdown Syntax, Code Blocks, Components, Images & Embeds).
  • Chores
    • Updates CI/CD to deploy the Documentation app.
    • Adds supporting configurations and dependencies for the docs app (build, lint, typecheck, runtime).

@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Sep 29, 2025

⚠️ No Changeset found

Latest commit: e62bbd8

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Sep 29, 2025

Caution

Review failed

The pull request is closed.

Walkthrough

Adds a new “docs” app to the monorepo: registers it in .github app listing, extends the CI deploy workflow to deploy docs via Cloudflare Wrangler, introduces Nuxt/Docus-based documentation content and configs under apps/docs, updates workspace (pnpm) dependencies and build settings.

Changes

Cohort / File(s) Summary
App registry
\.github/ucdjs-apps.json
Adds a new app entry: { name: "docs", display_name: "Documentation", deployable: true }.
CI deployment workflow
\.github/workflows/deploy-app.yml
Adds a docs deployment step (Cloudflare Wrangler) gated on matrix.app == "docs" and not dry-run. Mirrors existing deploy steps.
Docs app: content – Getting Started
apps/docs/content/1.getting-started/.navigation.yml, apps/docs/content/1.getting-started/2.introduction.md, apps/docs/content/1.getting-started/3.installation.md, apps/docs/content/1.getting-started/4.project-structure.md, apps/docs/content/1.getting-started/5.studio.md, apps/docs/content/1.getting-started/6.migration.md
Introduces navigation and multiple getting-started pages with front matter and rich content. No runtime logic.
Docs app: content – Essentials
apps/docs/content/2.essentials/.navigation.yml, apps/docs/content/2.essentials/1.markdown-syntax.md, apps/docs/content/2.essentials/2.code-blocks.md, apps/docs/content/2.essentials/3.components.md, apps/docs/content/2.essentials/4.images-embeds.md
Adds essentials section pages documenting Markdown, code blocks, components, and media usage.
Docs app: homepage
apps/docs/content/index.md
Adds docs home page with hero, links, and feature sections.
Docs app: configuration/build
apps/docs/nuxt.config.ts, apps/docs/wrangler.jsonc, apps/docs/turbo.json, apps/docs/tsconfig.json, apps/docs/eslint.config.mjs
Sets up Nuxt modules and Cloudflare preset, Wrangler deployment config, Turbo tasks, TS references, and ESLint wrapper.
Docs app: packaging & meta
apps/docs/package.json, apps/docs/.gitignore, apps/docs/README.md
Adds package manifest with scripts/dependencies, ignores for builds/dev, and a README describing the docs starter.
Workspace config
pnpm-workspace.yaml
Adds docs-related packages/group, marks built dependencies, and extends overrides/patches (incl. openapi-fetch).

Sequence Diagram(s)

sequenceDiagram
  autonumber
  actor Dev as Developer
  participant GH as GitHub Actions (deploy-app.yml)
  participant MX as Matrix (api | web | docs)
  participant WR as Wrangler CLI
  participant CF as Cloudflare

  Dev->>GH: Push/merge to main
  GH->>MX: Expand job matrix
  alt Matrix item == docs
    GH->>GH: Build docs
    GH->>WR: Deploy (workingDirectory=./apps/docs)
    WR->>CF: Publish worker/assets
    CF-->>GH: Deployment status
  else Other apps
    GH->>GH: Run respective deploy steps
  end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Suggested labels

apps: web

Poem

I thump my paws on fresh new scrolls,
Pages bloom where the pipeline rolls.
Nuxty nibbles, Docus treats,
Wrangler whisks to Cloudflare streets.
With ears up high I ship with cheer—
Our docs burrow is crystal clear! 🥕📚

✨ Finishing touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs-app

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 526e6cd and e62bbd8.

⛔ Files ignored due to path filters (2)
  • apps/docs/public/favicon.ico is excluded by !**/*.ico
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (23)
  • .github/ucdjs-apps.json (1 hunks)
  • .github/workflows/deploy-app.yml (1 hunks)
  • apps/docs/.gitignore (1 hunks)
  • apps/docs/README.md (1 hunks)
  • apps/docs/content/1.getting-started/.navigation.yml (1 hunks)
  • apps/docs/content/1.getting-started/2.introduction.md (1 hunks)
  • apps/docs/content/1.getting-started/3.installation.md (1 hunks)
  • apps/docs/content/1.getting-started/4.project-structure.md (1 hunks)
  • apps/docs/content/1.getting-started/5.studio.md (1 hunks)
  • apps/docs/content/1.getting-started/6.migration.md (1 hunks)
  • apps/docs/content/2.essentials/.navigation.yml (1 hunks)
  • apps/docs/content/2.essentials/1.markdown-syntax.md (1 hunks)
  • apps/docs/content/2.essentials/2.code-blocks.md (1 hunks)
  • apps/docs/content/2.essentials/3.components.md (1 hunks)
  • apps/docs/content/2.essentials/4.images-embeds.md (1 hunks)
  • apps/docs/content/index.md (1 hunks)
  • apps/docs/eslint.config.mjs (1 hunks)
  • apps/docs/nuxt.config.ts (1 hunks)
  • apps/docs/package.json (1 hunks)
  • apps/docs/tsconfig.json (1 hunks)
  • apps/docs/turbo.json (1 hunks)
  • apps/docs/wrangler.jsonc (1 hunks)
  • pnpm-workspace.yaml (1 hunks)

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov
Copy link
Copy Markdown

codecov bot commented Sep 29, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

* Updated the action reference for `manage-apps` to a specific commit SHA in both `deploy-app.yml` and `deploy-preview.yml`.
* Ensures consistency and stability in the deployment process by locking the action to a known state.
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Sep 29, 2025

🌏 Preview Deployments

Application Status Preview URL
API ✅ Deployed View Preview
Website ✅ Deployed View Preview
Documentation ❌ Failed N/A

Built from commit: e62bbd884f268733be8f0445d49421f5b04d5158


🤖 This comment will be updated automatically when you push new commits to this PR.

- Introduced a new `tsconfig.json` file to manage TypeScript configurations for the documentation app.
- References existing Nuxt.js TypeScript configuration files for proper type checking and compilation.
…ngler support

- Added Nitro configuration for Cloudflare module in nuxt.config.ts
- Updated package.json to include Wrangler for worker deployments
- Created turbo.json for task management with Turbo
- Added wrangler.jsonc for Cloudflare worker configuration
- Updated pnpm-lock.yaml to reflect new dependencies and versions
* Set `deployConfig` to `false` in `nuxt.config.ts` for Cloudflare compatibility.
* Added `main`, `assets`, and `compatibility_flags` sections in `wrangler.jsonc` for improved deployment settings.
* Added `environment` input to the deployment step in `deploy-app.yml`.
* Removed unused `nodeCompat` option from `nuxt.config.ts`.
* Cleaned up `wrangler.jsonc` by removing the `unsafe` bindings section.
@luxass luxass marked this pull request as ready for review October 1, 2025 04:26
Copilot AI review requested due to automatic review settings October 1, 2025 04:26
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 adds a new documentation application to the UCDJS project using the Docus framework with Nuxt 4. The documentation site provides comprehensive content including getting started guides, markdown syntax examples, and components documentation, and is configured for deployment on Cloudflare Pages.

  • Adds a complete docs app with Docus/Nuxt configuration and extensive markdown content
  • Integrates the docs app into the existing CI/CD pipeline and workspace structure
  • Sets up Cloudflare deployment configuration with environment-specific settings

Reviewed Changes

Copilot reviewed 23 out of 26 changed files in this pull request and generated 2 comments.

File Description
pnpm-workspace.yaml Adds docs catalog with dependencies and includes better-sqlite3 in build dependencies
apps/docs/* Complete documentation app setup with Nuxt/Docus configuration, content structure, and deployment files
.github/workflows/deploy-app.yml Adds deployment step for docs app in CI/CD pipeline
.github/ucdjs-apps.json Registers docs app as deployable application

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@github-actions github-actions bot added the 🚨 ci Changes related to our CI pipelines label Oct 1, 2025
@luxass luxass merged commit b5327d0 into main Oct 1, 2025
24 of 26 checks passed
@luxass luxass deleted the docs-app branch October 1, 2025 04:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🚨 ci Changes related to our CI pipelines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants