Skip to content

update docs#15

Merged
cobraprojects merged 2 commits into
mainfrom
update-docs
May 1, 2026
Merged

update docs#15
cobraprojects merged 2 commits into
mainfrom
update-docs

Conversation

@cobraprojects

@cobraprojects cobraprojects commented May 1, 2026

Copy link
Copy Markdown
Owner

Summary by CodeRabbit

Documentation

  • Updated all installation and setup guides to prioritize npm as the primary package manager, replacing the previous Bun-first approach
  • CLI command examples now use npx instead of bunx for running Holo commands across all feature modules
  • Build and development workflow examples changed from bun run to npm run commands
  • Bun remains fully supported as an alternative package manager option

@coderabbitai

coderabbitai Bot commented May 1, 2026

Copy link
Copy Markdown

Warning

Rate limit exceeded

@cobraprojects has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 47 minutes and 44 seconds before requesting another review.

To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 8366f9fa-85c7-46ae-b56b-cc3a5b93cca0

📥 Commits

Reviewing files that changed from the base of the PR and between 2704a4c and 3fcb6a2.

📒 Files selected for processing (4)
  • apps/docs/docs/installation.md
  • apps/docs/docs/orm/index.md
  • packages/cache/tests/docs-smoke.test.ts
  • packages/cli/tests/cli.test.ts
📝 Walkthrough

Walkthrough

Documentation and CLI tooling are updated to prioritize npm scaffolding (npm create holo-js@latest) and command execution (npx holo) over Bun equivalents, while maintaining Bun as a supported alternative. CLI package manager ordering is reordered to list npm first. All related documentation examples and smoke tests are updated consistently.

Changes

Cohort / File(s) Summary
Documentation - Installation & Project Setup
README.md, apps/docs/docs/installation.md, apps/docs/docs/index.md
Updated scaffolding commands from Bun-first to npm-first (npm create holo-js@latest), reordered package manager alternatives, and restructured core command guidance to use npm run for framework lifecycle and npx holo for CLI tools.
Documentation - Feature Setup
apps/docs/docs/auth/email-verification.md, apps/docs/docs/auth/index.md, apps/docs/docs/auth/social-login.md, apps/docs/docs/authorization/index.md, apps/docs/docs/events/setup-and-cli.md, apps/docs/docs/mail/setup-and-cli.md, apps/docs/docs/notifications/setup-and-cli.md
Updated CLI command invocations from bunx holo to npx holo across auth installation, social login providers, authorization, events, mail, and notifications modules.
Documentation - Operational Commands
apps/docs/docs/cache/config-and-drivers.md, apps/docs/docs/cache/setup-and-cli.md, apps/docs/docs/database/commands.md, apps/docs/docs/database/index.md, apps/docs/docs/database/migrations.md, apps/docs/docs/orm/index.md, apps/docs/docs/queue/database.md, apps/docs/docs/queue/failed-jobs.md, apps/docs/docs/queue/index.md, apps/docs/docs/queue/jobs.md, apps/docs/docs/queue/media.md, apps/docs/docs/queue/workers.md
Updated all CLI command examples from bunx holo to npx holo for cache, database, ORM, and queue operations; also updated framework lifecycle commands from bun run to npm run.
Documentation - Development & Deployment
apps/docs/docs/deployment.md, apps/docs/docs/development/index.md, apps/docs/docs/development/workflow.md, apps/docs/docs/directory-structure.md, apps/docs/docs/media.md, apps/docs/docs/security.md
Updated build and development commands from bun run and bunx holo to npm run and npx holo for deployment artifacts, pre-merge validation, and media/security operations.
CLI Package Manager Configuration
packages/cli/src/metadata.ts, packages/cli/src/parsing.ts, packages/cli/src/project/shared.ts
Reordered supported package managers to list npm first (['npm', 'pnpm', 'yarn', 'bun']); updated default package manager selection from Bun to npm in interactive and non-interactive project scaffolding paths.
Documentation Smoke Tests
packages/auth/tests/docs-smoke.test.ts, packages/broadcast/tests/docs-smoke.test.ts, packages/cache/tests/docs-smoke.test.ts, packages/mail/tests/docs-smoke.test.ts, packages/notifications/tests/docs-smoke.test.ts, packages/security/tests/docs-smoke.test.ts
Updated test assertions to expect npx holo instead of bunx holo command invocations in documented workflows.
Build Scripts
packages/media/package.json
Changed build and stub scripts to invoke tsup directly instead of via Bun (bun x tsup).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • fix user facing api #11: Modifies CLI package-manager ordering and scaffold metadata in packages/cli/src/, sharing the same configuration reordering pattern.
  • security package #3: Updates CLI parsing surface in packages/cli/src/parsing.ts for optional install targets, touching overlapping scaffolding infrastructure.

Poem

🐰 Hopping from Bun to npm's embrace,
The docs now run at a swifter pace,
With npx holo on every line,
npm-first defaults? Simply divine!
Bun still welcome—just takes a back seat,
This refactor makes developer workflows complete! 🎉

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'update docs' is generic and vague, lacking specificity about what documentation was updated or why. While the changeset is primarily documentation-focused, the title does not convey the main substance of the changes. Consider using a more specific title that summarizes the primary change, such as 'Update documentation to use npm as primary package manager' or 'Replace bunx with npx in documentation examples'.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch update-docs

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
Review rate limit: 0/1 reviews remaining, refill in 47 minutes and 44 seconds.

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (2)
apps/docs/docs/orm/index.md (1)

54-54: ⚡ Quick win

Normalize CLI invocation style within this page.

This page now mixes npx holo ... and bare holo ... commands, which can be unclear about prerequisites. Consider one convention (or a short note explaining both forms).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@apps/docs/docs/orm/index.md` at line 54, The page mixes two CLI invocation
styles ("npx holo migrate" and bare "holo ..."); choose one convention
(preferably include "npx " for clarity about prerequisites) and update every
command instance to that style (e.g., replace occurrences of "holo" with "npx
holo" or vice versa), or add a single note near the top explaining both forms
and when to use each; update the line containing "npx holo migrate" and any
other command examples to match the chosen convention and ensure wording around
the commands (like "refreshes server/db/schema.generated.ts") remains accurate.
packages/cache/tests/docs-smoke.test.ts (1)

22-27: ⚡ Quick win

Add coverage for the new scaffold example.

The smoke test now checks the updated command strings, but it still won't catch regressions in the new project-scaffolding snippet.

Proposed test update
     const installation = await readFile(resolve(root, 'apps/docs/docs/installation.md'), 'utf8')
     const index = await readCacheDoc('index.md')
     const setup = await readCacheDoc('setup-and-cli.md')
+    expect(setup).toContain('npm create holo-js@latest my-app -- --package cache')
     const config = await readCacheDoc('config-and-drivers.md')
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@packages/cache/tests/docs-smoke.test.ts` around lines 22 - 27, The test only
asserts existing cache CLI lines but misses the new project-scaffolding example;
update packages/cache/tests/docs-smoke.test.ts to add an expectation against the
setup variable for the new scaffold example so regressions are caught, following
the same pattern as the other expect(setup).toContain assertions and placing it
alongside the other cache command assertions.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@apps/docs/docs/installation.md`:
- Around line 162-164: Replace the plain `holo prepare` example with the
exec/wrapper form used elsewhere so it works in a fresh install (e.g., use the
`npx holo prepare` style); update the text that refers to "Run `holo prepare`
directly" to instead say "Run `npx holo prepare`" (or the equivalent
package-manager exec wrapper) so the documentation matches the surrounding `npx
holo ...` guidance and won’t fail when the binary isn't globally installed.

In `@packages/cli/src/parsing.ts`:
- Around line 238-242: The code changed the non-interactive fallback package
manager to 'npm' (see resolveStringFlag, normalizeChoice,
SUPPORTED_NEW_PACKAGE_MANAGERS and prompts.choose in parsing.ts), so update the
'defaults-app' test and any other tests that call resolveNewProjectInput with
empty flags to expect packageManager: 'npm' instead of 'bun'; find assertions or
fixtures referencing 'bun' (including the test at the previous line ~3650) and
replace them with 'npm' (or alternatively adjust the test setup to explicitly
set the package-manager flag to 'bun' if you want to preserve the old behavior).

---

Nitpick comments:
In `@apps/docs/docs/orm/index.md`:
- Line 54: The page mixes two CLI invocation styles ("npx holo migrate" and bare
"holo ..."); choose one convention (preferably include "npx " for clarity about
prerequisites) and update every command instance to that style (e.g., replace
occurrences of "holo" with "npx holo" or vice versa), or add a single note near
the top explaining both forms and when to use each; update the line containing
"npx holo migrate" and any other command examples to match the chosen convention
and ensure wording around the commands (like "refreshes
server/db/schema.generated.ts") remains accurate.

In `@packages/cache/tests/docs-smoke.test.ts`:
- Around line 22-27: The test only asserts existing cache CLI lines but misses
the new project-scaffolding example; update
packages/cache/tests/docs-smoke.test.ts to add an expectation against the setup
variable for the new scaffold example so regressions are caught, following the
same pattern as the other expect(setup).toContain assertions and placing it
alongside the other cache command assertions.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 9e4a9e91-d2a9-4409-8c30-e3c13ce1f30c

📥 Commits

Reviewing files that changed from the base of the PR and between 3ffb2db and 2704a4c.

📒 Files selected for processing (38)
  • README.md
  • apps/docs/docs/auth/email-verification.md
  • apps/docs/docs/auth/index.md
  • apps/docs/docs/auth/social-login.md
  • apps/docs/docs/authorization/index.md
  • apps/docs/docs/cache/config-and-drivers.md
  • apps/docs/docs/cache/setup-and-cli.md
  • apps/docs/docs/database/commands.md
  • apps/docs/docs/database/index.md
  • apps/docs/docs/database/migrations.md
  • apps/docs/docs/deployment.md
  • apps/docs/docs/development/index.md
  • apps/docs/docs/development/workflow.md
  • apps/docs/docs/directory-structure.md
  • apps/docs/docs/events/setup-and-cli.md
  • apps/docs/docs/index.md
  • apps/docs/docs/installation.md
  • apps/docs/docs/mail/setup-and-cli.md
  • apps/docs/docs/media.md
  • apps/docs/docs/notifications/setup-and-cli.md
  • apps/docs/docs/orm/index.md
  • apps/docs/docs/queue/database.md
  • apps/docs/docs/queue/failed-jobs.md
  • apps/docs/docs/queue/index.md
  • apps/docs/docs/queue/jobs.md
  • apps/docs/docs/queue/media.md
  • apps/docs/docs/queue/workers.md
  • apps/docs/docs/security.md
  • packages/auth/tests/docs-smoke.test.ts
  • packages/broadcast/tests/docs-smoke.test.ts
  • packages/cache/tests/docs-smoke.test.ts
  • packages/cli/src/metadata.ts
  • packages/cli/src/parsing.ts
  • packages/cli/src/project/shared.ts
  • packages/mail/tests/docs-smoke.test.ts
  • packages/media/package.json
  • packages/notifications/tests/docs-smoke.test.ts
  • packages/security/tests/docs-smoke.test.ts

Comment thread apps/docs/docs/installation.md
Comment thread packages/cli/src/parsing.ts
@cobraprojects
cobraprojects merged commit 4fcb1bc into main May 1, 2026
1 check passed
@cobraprojects
cobraprojects deleted the update-docs branch May 1, 2026 03:56
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.

1 participant