Skip to content

Conversation

@emily-shen
Copy link
Contributor

@emily-shen emily-shen commented Apr 3, 2025

Summary

update hono, react and vue docs

Add a bindings partial with a nice big link button and apply it everywhere

remove redundant c3 steps everywhere

remove unhelpful 'static assets' section, because this use of 'static assets' means something different to how we use it everywhere else. replaced it with 'routing' where helpful (just for the SPAs, basically)

Screenshots (optional)

Documentation checklist

  • The documentation style guide has been adhered to.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

@hyperlint-ai
Copy link
Contributor

hyperlint-ai bot commented Apr 3, 2025

Howdy and thanks for contributing to our repo. The Cloudflare team reviews new, external PRs within two (2) weeks. If it's been two weeks or longer without any movement, please tag the PR Assignees in a comment.

We review internal PRs within 1 week. If it's something urgent or has been sitting without a comment, start a thread in the Developer Docs space internally.


PR Change Summary

Updated the Hono documentation to enhance clarity and provide a more structured approach for creating full-stack applications with Hono and React.

  • Revised the project setup instructions to include a new template for creating Hono applications.
  • Added detailed steps for local development using the Cloudflare Vite plugin.
  • Included a simplified file tree for better understanding of project structure.

Modified Files

  • src/content/docs/workers/frameworks/framework-guides/hono.mdx

How can I customize these reviews?

Check out the Hyperlint AI Reviewer docs for more information on how to customize the review.

If you just want to ignore it on this PR, you can add the hyperlint-ignore label to the PR. Future changes won't trigger a Hyperlint review.

Note specifically for link checks, we only check the first 30 links in a file and we cache the results for several hours (for instance, if you just added a page, you might experience this). Our recommendation is to add hyperlint-ignore to the PR to ignore the link check for this PR.

@github-actions
Copy link
Contributor

github-actions bot commented Apr 3, 2025

Preview URL: https://9bdb3278.preview.developers.cloudflare.com
Preview Branch URL: https://emily-hono-new.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/workers/frameworks/framework-guides/hono/ https://emily-hono-new.preview.developers.cloudflare.com/workers/frameworks/framework-guides/hono/
https://developers.cloudflare.com/workers/frameworks/framework-guides/react/ https://emily-hono-new.preview.developers.cloudflare.com/workers/frameworks/framework-guides/react/
https://developers.cloudflare.com/workers/frameworks/framework-guides/vue/ https://emily-hono-new.preview.developers.cloudflare.com/workers/frameworks/framework-guides/vue/
https://developers.cloudflare.com/workers/frameworks/framework-guides/docusaurus/ https://emily-hono-new.preview.developers.cloudflare.com/workers/frameworks/framework-guides/docusaurus/
https://developers.cloudflare.com/workers/frameworks/framework-guides/gatsby/ https://emily-hono-new.preview.developers.cloudflare.com/workers/frameworks/framework-guides/gatsby/
https://developers.cloudflare.com/workers/frameworks/framework-guides/nuxt/ https://emily-hono-new.preview.developers.cloudflare.com/workers/frameworks/framework-guides/nuxt/
https://developers.cloudflare.com/workers/frameworks/framework-guides/qwik/ https://emily-hono-new.preview.developers.cloudflare.com/workers/frameworks/framework-guides/qwik/
https://developers.cloudflare.com/workers/frameworks/framework-guides/remix/ https://emily-hono-new.preview.developers.cloudflare.com/workers/frameworks/framework-guides/remix/
https://developers.cloudflare.com/workers/frameworks/framework-guides/solid/ https://emily-hono-new.preview.developers.cloudflare.com/workers/frameworks/framework-guides/solid/
https://developers.cloudflare.com/workers/frameworks/framework-guides/svelte/ https://emily-hono-new.preview.developers.cloudflare.com/workers/frameworks/framework-guides/svelte/
https://developers.cloudflare.com/workers/frameworks/framework-guides/angular/ https://emily-hono-new.preview.developers.cloudflare.com/workers/frameworks/framework-guides/angular/

@cloudflare cloudflare deleted a comment Apr 3, 2025
@emily-shen emily-shen force-pushed the emily/hono-new branch 2 times, most recently from f9ccad0 to c673b99 Compare April 3, 2025 18:59
@emily-shen emily-shen changed the title update hono + assets docs update various framework guides (hono, react etc.) Apr 3, 2025
@github-actions github-actions bot added size/m and removed size/s labels Apr 3, 2025
Copy link
Contributor

@jamesopstad jamesopstad left a comment

Choose a reason for hiding this comment

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

Looks great! Just added a few suggestions.

Use the [`create-cloudflare`](https://www.npmjs.com/package/create-cloudflare) CLI (C3) to set up a new project. C3 will create a new project directory, use code from the official Hono template, and provide the option to deploy instantly.

To use `create-cloudflare` to create a new Hono project with <InlineBadge preset="beta" /> Workers Assets, run the following command:
**Start from CLI** - scaffold a full-stack app with a Hono API, React SPA and the Cloudflare Vite plugin for lightning-fast development.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
**Start from CLI** - scaffold a full-stack app with a Hono API, React SPA and the Cloudflare Vite plugin for lightning-fast development.
**Start from the CLI** - scaffold a full-stack app with a Hono API, React SPA and the Cloudflare Vite plugin for lightning-fast development.

</FileTree>

Your project can be deployed to a `*.workers.dev` subdomain or a [Custom Domain](/workers/configuration/routing/custom-domains/), from your own machine or from any CI/CD system, including [Cloudflare's own](/workers/ci-cd/builds/).
`wrangler.jsonc` is your [Wrangler configuration file](/workers/wrangler/configuration/).
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
`wrangler.jsonc` is your [Wrangler configuration file](/workers/wrangler/configuration/).
`wrangler.jsonc` is your [Worker configuration file](/workers/wrangler/configuration/).

Copy link
Contributor Author

Choose a reason for hiding this comment

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

we use "wrangler configuration file" everywhere else across the docs, unless you feel strongly about it, i'd prefer to keep it consistent. Especially since that file configures more than just your worker (e.g. resources), for better or worse 🥲

Copy link
Contributor

Choose a reason for hiding this comment

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

Fair enough. I used 'Worker config file' in the Vite plugin docs but we can revisit this at a later date.

Use the [`create-cloudflare`](https://www.npmjs.com/package/create-cloudflare) CLI (C3) to set up a new project. C3 will create a new project directory, use code from the official React template, and provide the option to deploy instantly.

To use `create-cloudflare` to create a new React project with <InlineBadge preset="beta" /> Workers Assets, run the following command:
**Start from CLI** - scaffold a full-stack app with a React SPA, Cloudflare Workers API, and the Cloudflare Vite plugin for lightning-fast development.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
**Start from CLI** - scaffold a full-stack app with a React SPA, Cloudflare Workers API, and the Cloudflare Vite plugin for lightning-fast development.
**Start from the CLI** - scaffold a full-stack app with a React SPA, Cloudflare Workers API, and the Cloudflare Vite plugin for lightning-fast development.

Copy link
Contributor

@korinne korinne left a comment

Choose a reason for hiding this comment

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

Looks great, thank you so much @emily-shen

@korinne korinne merged commit fffa3a3 into production Apr 7, 2025
11 checks passed
@korinne korinne deleted the emily/hono-new branch April 7, 2025 17:57
RebeccaTamachiro pushed a commit that referenced this pull request Apr 21, 2025
* update hono docs

* f

* add bindings partial

* update vue a bit

* add bindings partial to hono

* and the rest of them

* Apply suggestions from code review

Co-authored-by: James Opstad <[email protected]>

* add links to vite plugin

---------

Co-authored-by: James Opstad <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:workers Related to Workers product size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants