Skip to content

Document asset helpers serving from the development server - #654

Merged
tricknotes merged 3 commits into
mainfrom
dev-server-asset-helpers
Sep 4, 2026
Merged

Document asset helpers serving from the development server#654
tricknotes merged 3 commits into
mainfrom
dev-server-asset-helpers

Conversation

@tricknotes

@tricknotes tricknotes commented Sep 2, 2026

Copy link
Copy Markdown
Owner

Summary

Companion to tricknotes/ember-cli-rails-assets#35, released as ember-cli-rails-assets 0.9.0: include_ember_script_tags reads index.html from Vite's development server and emits the startup tags with absolute URLs pointing at it, so embedding a Vite-based application into Rails-owned HTML no longer requires dev_server: false, and changes are picked up by reloading the page instead of waiting for a full build.

The API the helper needs (App#dev_server?, and App#dev_server with index_html and origin) is already public on the #653 branch, so this side is documentation and dependency housekeeping:

  • Raise the gemspec's ember-cli-rails-assets constraint to >= 0.9.0, the release that carries the development-server support (verified to resolve)
  • Update the README and UPGRADING passages that hedged about older ember-cli-rails-assets releases: the helpers' development-server behavior is now stated plainly, and dev_server: false is described as the opt-out it is (the helpers then read the build output, built once on the first request)
  • State in the upgrading guide that the development server is the default and recommended setup for Vite-based applications, with a reference configuration (a fixed port so that several Rails workers share one server, and a longer timeout for a slow first boot)
  • Fold the requirement change into the CHANGELOG entry

Stacked directly on #653 (the interim vite-recompile-on-change base was dropped).

🤖 Generated with Claude Code

@tricknotes
tricknotes force-pushed the dev-server-asset-helpers branch from b3eb0ec to fa5c46f Compare September 3, 2026 16:06
@tricknotes
tricknotes force-pushed the vite-recompile-on-change branch from de1c51e to db2e1f4 Compare September 3, 2026 16:06
@tricknotes
tricknotes force-pushed the dev-server-asset-helpers branch from 98d8ac0 to b332374 Compare September 3, 2026 18:21
@tricknotes
tricknotes changed the base branch from vite-recompile-on-change to claude/vite-dev-server-hmr-y3xm8i September 3, 2026 18:21
@tricknotes
tricknotes force-pushed the claude/vite-dev-server-hmr-y3xm8i branch from c1f47c1 to 5ba5dd3 Compare September 4, 2026 08:08
With the ember-cli-rails-assets release carrying tricknotes/ember-cli-rails-assets#35, `include_ember_script_tags` reads `index.html` from the development server and emits absolute URLs pointing at it, so the helpers no longer require `dev_server: false`.
Update the passages that said the helpers always read the build output.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
ember-cli-rails-assets 0.9.0 is released and serves the include_ember_script_tags startup tags from Vite's development server, so raise the gemspec constraint and state the behavior plainly in the documentation instead of hedging about older releases. The dev_server: false path is now described as the opt-out it is: the helpers then read the build output, built once, synchronously, on the first request.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
State in the upgrading guide that the development server is the default and recommended setup, with a reference configuration: a fixed port so that several Rails workers share one server, and a longer timeout for a slow first boot.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@tricknotes
tricknotes force-pushed the dev-server-asset-helpers branch from 48d7fc9 to fe2a21b Compare September 4, 2026 08:09
Base automatically changed from claude/vite-dev-server-hmr-y3xm8i to main September 4, 2026 08:20
@tricknotes
tricknotes merged commit 07d180d into main Sep 4, 2026
12 checks passed
@tricknotes
tricknotes deleted the dev-server-asset-helpers branch September 4, 2026 08:20
@tricknotes tricknotes mentioned this pull request Sep 4, 2026
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.

2 participants