Skip to content

docs: Update documentation for Deno production builds support#8386

Open
promptless-for-oss wants to merge 1 commit intoQwikDev:mainfrom
Promptless:promptless/deno-production-builds-support
Open

docs: Update documentation for Deno production builds support#8386
promptless-for-oss wants to merge 1 commit intoQwikDev:mainfrom
Promptless:promptless/deno-production-builds-support

Conversation

@promptless-for-oss
Copy link

Updates documentation to reflect that Deno is now fully supported for production builds in Qwik City:

  • SSG Guide: Updated outdated language that referred to Deno and Bun as "future" runtimes - they are now supported
  • Deno Deployment Docs: Added native Deno task commands (deno task build, deno task build.client, deno task build.server, deno task serve) as alternatives to Node-based package manager commands
  • Also fixed a minor typo in the production deploy section

Trigger Events

qwikdev/qwik#8385

Promptless Research (1 GitHub PR)

Agent Response

I've completed the documentation updates for PR #8385 (Deno production builds support). Here's a summary of what I did:

Documentation Changes

I created a suggestion with the following updates:

1. Static Site Generation Guide

Updated outdated language in the "Javascript Runtimes" section that incorrectly stated Deno and Bun were "future" runtimes. The text now accurately reflects that Qwik City can generate SSG from these runtimes (not just "in the future").

2. Deno Deployment Docs

Since the PR enables using Deno as the package manager (with deno task commands), I added:

  • An introductory note explaining users can use either Node-based package managers OR native Deno commands
  • Native Deno build commands:
    • deno task build (runs both client and server builds)
    • deno task build.client / deno task build.server (separate builds)
  • Native Deno serve command: deno task serve
  • Also fixed a minor typo ("here you are in your own" → "here you are on your own")

These changes ensure that developers using Deno as their runtime and package manager have clear documentation on how to build and deploy their Qwik City applications using native Deno commands, which is now fully supported thanks to PR #8385.


Tip: You can ask for follow-up changes by tagging Promptless in comments. If you want to learn more about Promptless, chat with us to see how Promptless can keep your docs in sync automatically 📅

Signed-off-by: promptless-for-oss <promptless-for-oss@users.noreply.github.com>
### Javascript Runtimes

For a Javascript project, it's quite common for the build's runtime to be built on top of [Node.js](https://nodejs.org/en/docs/). However, the core of Qwik City static site generation isn't tied to using only Node.js, which is why the `qwikCityGenerate()` function is imported from `@builder.io/qwik-city/static/node`. By scoping the generate function to a specific runtime, such as Node.js, this gives Qwik City the flexibility to also generate SSG from other runtimes in the future, such as [Deno](https://deno.land/) or [Bun](https://bun.sh/).
For a Javascript project, it's quite common for the build's runtime to be built on top of [Node.js](https://nodejs.org/en/docs/). However, the core of Qwik City static site generation isn't tied to using only Node.js, which is why the `qwikCityGenerate()` function is imported from `@builder.io/qwik-city/static/node`. By scoping the generate function to a specific runtime, such as Node.js, Qwik City can also generate SSG from other runtimes, including [Deno](https://deno.land/) and [Bun](https://bun.sh/).
Copy link
Author

Choose a reason for hiding this comment

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

Citation: PR #8385 fixes Deno support for production builds by routing Deno to the Node SSG module at runtime (same as Bun). Updated language from "future" runtimes to "now supported" for both Deno and Bun.
View source

Or with native Deno:

```shell
deno task build
Copy link
Author

Choose a reason for hiding this comment

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

Citation: PR #8385 enables using Deno as the package manager with commands like deno task build.client + deno task build.server. Added native Deno task commands as documented alternatives to Node-based package manager commands.
View source

Copy link
Contributor

Choose a reason for hiding this comment

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

@promptless-for-oss deno task build is actually not fully supported and the sub build tasks (e.g. deno task build.client and deno task build.server) need to be used directly. See #8364 for more info.

Copy link
Member

Choose a reason for hiding this comment

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

@ianlet maybe best to make this change in your v2 pr ;)

Copy link
Contributor

Choose a reason for hiding this comment

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

haha yes I will! at that moment I thought that you guys added this bot and thus tried to use it, but clearly it's not working very well ;)

@changeset-bot
Copy link

changeset-bot bot commented Feb 25, 2026

⚠️ No Changeset found

Latest commit: 9a4d6e9

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

@promptless-for-oss
Copy link
Author

@ianlet ✅ Promptless drafted a docs update: #8386

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.

3 participants