vident:install generator

bin/rails g vident:install

The generator does three things, all idempotent.

1. config/initializers/vident.rb

Configures Vident’s request-scoped stable ID strategy and gives you a single place to override defaults.

2. ApplicationController patch

Adds a before_action that seeds the stable ID generator per request using a fresh seed. The seed makes element IDs deterministic within a request (so cached fragments rehydrate cleanly) without colliding across requests.

If your app already has its own before_action setup, the generator inserts the seeding call alongside the existing ones — review the diff before committing.

3. (Optional) .claude/skills/vident/SKILL.md

Drops a Claude Code skill that teaches the model Vident’s conventions: typed props, the stimulus do block, root_element, and the file layout for sidecar controllers. Re-run the generator with --force when you upgrade Vident to refresh this file.

Flags

Rendering outside a request

If you render Vident components in places without a Rails request — Rake tasks, ActionMailer previews, scripts that exercise components in isolation — wrap the render in Vident::StableId.with_sequence_generator(seed: "any-string"). See Element IDs and seeding for the details.