Skip to content

docs: replace Modular Forms integration with Formisch - #9317

Merged
wmertens merged 3 commits into
QwikDev:mainfrom
fabian-hiller:docs/replace-modular-forms-with-formisch
Oct 28, 2026
Merged

wmertens merged 3 commits into
QwikDev:mainfrom
fabian-hiller:docs/replace-modular-forms-with-formisch

Conversation

@fabian-hiller

@fabian-hiller fabian-hiller commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

What is it?

  • Docs / tests / types / typos

Description

Modular Forms is built with Qwik v1 and does not work with Qwik v2. Formisch is its successor (same author) and already has an integration guide on the docs. This PR makes Formisch the only form library integration on the v2 docs:

  • Remove the Modular Forms guide and its demo route, and drop @modular-forms/qwik from the docs dependencies and Vite config
  • Redirect /docs/integrations/modular-forms/ to /docs/integrations/formisch/ (308) in both _redirects and plugin@redirects.ts
  • Remove Modular Forms from the docs menu
  • Replace the Modular Forms entries in the ecosystem libraries list and on the community projects page with Formisch
  • Update the Qwik v1 note in the Formisch guide to link to modularforms.dev instead of the removed page, and drop the "currently in beta" wording

Blog posts that mention Modular Forms are left unchanged. packages/insights still depends on @modular-forms/qwik and is not touched by this PR.

Checklist

  • My code follows the developer guidelines of this project
  • I performed a self-review of my own code
  • Verified locally with pnpm dev that the Formisch guide renders and the old URL redirects

Summary by CodeRabbit

  • Documentation
    • Updated the integrations and community project listings to feature Formisch instead of Modular Forms.
    • Updated the Formisch integration guide, including its Qwik version information.
    • Removed the Modular Forms integration guide and demo. Requests to the former guide URL now permanently redirect to the Formisch guide.

Modular Forms is built with Qwik v1 and does not work with Qwik v2.
Formisch is its successor by the same author, so remove the Modular
Forms guide, demo and dependency, and redirect its URL to the Formisch
guide. Also swap the ecosystem and community project entries.
@fabian-hiller
fabian-hiller requested review from a team as code owners October 28, 2026 03:11
@changeset-bot

changeset-bot Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 9a828b4

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

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ⚠️ Failed 2026-10-28T03:13:30.425215Z
We couldn’t complete this review. Comment @codex review to try again.
021dadc PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@coderabbitai

coderabbitai Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Important

Review skipped

Review was skipped as selected files did not have any reviewable changes.

Files ignored due to path filters: 3
  • packages/docs/public/ecosystem/formisch.svg is excluded by !**/*.svg
  • packages/docs/public/ecosystem/modular-forms.svg is excluded by !**/*.svg
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 6b3b7a73-bf87-4cc9-b597-e04f8ca40b84
Commits

Reviewing files that changed from the base of the PR and between d48ba4d and 9a828b4.

Files ignored due to path filters: 3
  • packages/docs/public/ecosystem/formisch.svg is excluded by !**/*.svg
  • packages/docs/public/ecosystem/modular-forms.svg is excluded by !**/*.svg
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

No actionable comments were generated in the recent review.

Recent review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 7856635b-6843-4159-a9b6-51c8b8c9812b
Commits

Reviewing files that changed from the base of the PR and between b00bebf and 021dadc.

Files ignored due to path filters: 3
  • packages/docs/public/ecosystem/formisch.svg is excluded by !**/*.svg
  • packages/docs/public/ecosystem/modular-forms.svg is excluded by !**/*.svg
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
Files selected for processing: 10
  • packages/docs/package.json
  • packages/docs/public/_redirects
  • packages/docs/src/routes/(ecosystem)/ecosystem.json
  • packages/docs/src/routes/community/projects/index.mdx
  • packages/docs/src/routes/demo/integration/modular-forms/index.tsx
  • packages/docs/src/routes/docs/integrations/formisch/index.mdx
  • packages/docs/src/routes/docs/integrations/modular-forms/index.mdx
  • packages/docs/src/routes/docs/menu.md
  • packages/docs/src/routes/plugin@redirects.ts
  • packages/docs/vite.config.ts
Files with no reviewable changes: 4
  • packages/docs/src/routes/docs/menu.md
  • packages/docs/package.json
  • packages/docs/src/routes/docs/integrations/modular-forms/index.mdx
  • packages/docs/src/routes/demo/integration/modular-forms/index.tsx

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 9 remain after this review.

Walkthrough

The docs package replaces its Modular Forms integration content and ecosystem references with Formisch references. It removes the Modular Forms guide and demo, removes the package from docs dependencies and Vite settings, and redirects the old integration URL to Formisch.

Changes: Formisch documentation transition

Layer / File(s) Summary
Update Formisch references
packages/docs/src/routes/(ecosystem)/ecosystem.json, packages/docs/src/routes/community/projects/index.mdx, packages/docs/src/routes/docs/integrations/formisch/index.mdx
The ecosystem and community listings now feature Formisch. The Formisch integration page’s update date, Qwik version note, and fallback link are changed.
Retire Modular Forms documentation
packages/docs/src/routes/docs/integrations/modular-forms/index.mdx, packages/docs/src/routes/demo/integration/modular-forms/index.tsx, packages/docs/src/routes/docs/menu.md, packages/docs/public/_redirects, packages/docs/src/routes/plugin@redirects.ts
The Modular Forms guide, demo, and menu entry are removed. Both redirect configurations send the old integration URL to Formisch, with the public redirect using status 308.
Remove Modular Forms package configuration
packages/docs/package.json, packages/docs/vite.config.ts
The docs package no longer lists @modular-forms/qwik as a development dependency or in the specified Vite optimization and server resolution settings.

Priority: Pending latest changes

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Other

Possibly related PRs

  • QwikDev/qwik#9185: Adds migrate-v2 handling for Qwik 1 libraries and validates an app using @modular-forms/qwik.

Suggested reviewers: wmertens

Merge Risk: Minimal · previous review 021da

The documentation migration preserves the legacy URL through a redirect and removes the retired integration consistently.

Security architecture risk: Minimal · up to 021da

The retired guide redirects to a fixed documentation path on the same site. The existing redirect mechanism is unchanged, and the change does not give visitors control over the destination or introduce a material security risk.

Retained concerns
No architecture-level concerns identified.

Security review details

Security Blast Radius

  • inferred — The added mapping affects navigation to one public documentation path. Its fixed in-site destination does not introduce an attacker-selected external redirect or a privileged operation.

Trust Boundaries and Controls

  • observed — For this mapping, the visitor controls the requested pathname but not the redirect destination. The destination is a source-defined relative path; request query parameters and host values are not interpolated into it.
Pre-merge checks: Passed 5
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title clearly and concisely describes the primary change: replacing the Modular Forms integration with Formisch in the documentation.
Docstring Coverage Passed No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentat…
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.
Full details: Docstring Coverage

Explanation

No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 0 functions across 2 files. (4 skipped: 4 unsupported.)

Finishing Touches: 💡 1
🛠️ Fix failing CI checks: 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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

@pkg-pr-new

pkg-pr-new Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Open in StackBlitz

@qwik.dev/core

npm i https://pkg.pr.new/QwikDev/qwik/@qwik.dev/core@9317

@qwik.dev/router

npm i https://pkg.pr.new/QwikDev/qwik/@qwik.dev/router@9317

@qwik.dev/utils

npm i https://pkg.pr.new/QwikDev/qwik/@qwik.dev/utils@9317

eslint-plugin-qwik

npm i https://pkg.pr.new/QwikDev/qwik/eslint-plugin-qwik@9317

create-qwik

npm i https://pkg.pr.new/QwikDev/qwik/create-qwik@9317

@qwik.dev/optimizer

npm i https://pkg.pr.new/QwikDev/qwik/@qwik.dev/optimizer@9317

@qwik.dev/devtools

npm i https://pkg.pr.new/QwikDev/qwik/@qwik.dev/devtools@9317

@qwik.dev/mcp

npm i https://pkg.pr.new/QwikDev/qwik/@qwik.dev/mcp@9317

commit: 9a828b4

@github-actions

Copy link
Copy Markdown
Contributor

⚡ Docs preview for 9a828b4

@wmertens wmertens left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM 📝

@wmertens
wmertens merged commit 7ee33f5 into QwikDev:main Oct 28, 2026
55 checks passed
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