Softwr

Web Development · head to head

Stencil vs Stimulus

Stencil logo

Stencil

Web Development

MIT licensed toolchain for building reusable Web Component libraries in TypeScript

From
Free
Free plan
Yes
Stimulus logo

Stimulus

Web Development

Small JavaScript framework that adds behaviour to existing server rendered HTML

From
Free
Free plan
Yes

The short version

  • Stencil is an open source toolchain; Stimulus is an MIT licensed JavaScript framework.
  • Both are free.
  • Only Stencil lists shadow DOM and slots support; only Stimulus lists MIT licensed open source.
  • Where Stencil falls short: aimed at component libraries, so routing and data fetching must come from elsewhere.
  • Where Stimulus falls short: does not render templates, so HTML must come from the server or another tool.
  • Prices and features on this page were last checked on 20 November 2026.

How do Stencil and Stimulus differ?

Stencil and Stimulus differ on platforms. Only the attributes on which Stencil and Stimulus actually diverge.

Attributes where Stencil and Stimulus differ
AttributeStencilStimulus
PlatformsWeb, Windows, macOS, LinuxWeb

Identical on both: starting price (Free), pricing model (Open-source), free tier (Yes), category (Web Development).

Not yet recorded: founded for Stencil.

Which features does each one have?

They share no listed features; 8 appear only for Stencil and 7 only for Stimulus. Drawn from each product's published feature list. An absence here means we hold no record of it - not that the product lacks it.

Only in Stencil

  • Compiles TypeScript and JSX to Web Components
  • Shadow DOM and slots support
  • Output optimised for tree shaking and loading
  • Asynchronous rendering pipeline
  • Documentation generated from JSDoc comments
  • Dev server with hot reloading
  • Unit testing and code generation tooling
  • Integration guides for Angular, React and Vue

Only in Stimulus

  • Controllers attached through data-controller
  • Actions that bind DOM events to controller methods
  • Targets for locating elements inside a controller
  • Values that read, write and observe data attributes
  • Works with server rendered HTML
  • Designed to pair with Turbo in Hotwire
  • MIT licensed open source

What is each one used for?

Stencil is most often brought in for publishing a design system as Web Components; Stimulus for adding small interactions to Rails views. The jobs each tool is most often brought in to do.

Stencil

  • Publishing a design system as Web Componentsnot Stimulus
  • Sharing UI components across React, Angular and Vue appsnot Stimulus
  • Building framework independent widgetsnot Stimulus
  • Generating documentation for component librariesnot Stimulus
  • Building progressive web apps with Web Componentsnot Stimulus

Stimulus

  • Adding small interactions to Rails viewsnot Stencil
  • Progressive enhancement of server rendered pagesnot Stencil
  • Pairing with Turbo for fast page updatesnot Stencil
  • Replacing scattered jQuery codenot Stencil
  • Form and widget behaviour on existing HTMLnot Stencil

Where do Stencil and Stimulus fall short?

Stencil's most cited limit: aimed at component libraries, so routing and data fetching must come from elsewhere. Stimulus's: does not render templates, so HTML must come from the server or another tool. Documented limitations, not opinions. Every one is a constraint you would hit in normal use.

Stencil

  • Aimed at component libraries, so routing and data fetching must come from elsewhere
  • Requires TypeScript and decorator conventions that differ from other frameworks
  • Web Component styling and form handling can need extra work in some host frameworks
  • Smaller ecosystem of third party components than the largest frameworks

Stimulus

  • Does not render templates, so HTML must come from the server or another tool
  • No built in routing, data fetching or client side state management
  • Behaviour is tied to data attributes in markup, which some teams find harder to trace
  • Not a component framework, so large interactive interfaces need other libraries

How much do Stencil and Stimulus cost?

Stencil is free to use; Stimulus is free to use. Plan by plan below, from each vendor's own pricing page.

Stencil

Free

No published plan breakdown. See the Stencil review.

Stimulus

Free

No published plan breakdown. See the Stimulus review.

Which should you pick?

Choose Stencil if

  • You need compiles typescript and jsx to web components.
  • You want to start without paying.
  • You work on Web, Windows, macOS, Linux.
  • You also want shadow dom and slots support.

Choose Stimulus if

  • You need controllers attached through data-controller.
  • You want to start without paying.
  • You also want actions that bind dom events to controller methods.

Questions people ask

Is Stencil or Stimulus better?
Neither clearly leads. Stencil starts at Free and Stimulus at Free, and user ratings are close enough to be indistinguishable. Choose on capability and platform support.
Which is cheaper, Stencil or Stimulus?
Stencil starts at Free and Stimulus at Free.
Does Stencil or Stimulus run on more platforms?
Stencil runs on Web, Windows, macOS, Linux. Stimulus runs on Web.
Can I use Stencil for free?
Both have a free tier, so you can try either at no cost before committing.
What is Stencil best used for?
Stencil is most often used for publishing a design system as web components, sharing ui components across react, angular and vue apps, building framework independent widgets, generating documentation for component libraries. Of those, publishing a design system as web components and sharing ui components across react, angular and vue apps are not what Stimulus is typically brought in for.
What can Stencil do that Stimulus cannot?
Stencil covers Compiles TypeScript and JSX to Web Components, Shadow DOM and slots support, Output optimised for tree shaking and loading, Asynchronous rendering pipeline. Stimulus covers Controllers attached through data-controller, Actions that bind DOM events to controller methods, Targets for locating elements inside a controller, Values that read, write and observe data attributes.

Answered from the vendors’ own pages

Stencil: What does Stencil produce?

Stencil compiles components written in TypeScript and JSX into standard Web Components. These work in any major framework or without one.

Source
Stimulus: What is Stimulus used for?

Stimulus enhances HTML that already exists on the page by connecting JavaScript controllers to elements through data attributes. It does not generate the HTML itself.

Source
Stencil: Is Stencil free?

Yes. The project is released under the MIT licence according to both its website and its GitHub repository.

Source
Stimulus: What are the core concepts in Stimulus?

Controllers are the main unit, and they are joined by actions, targets and values. Actions link events to methods, targets find elements and values store state in data attributes.

Source
Stencil: Who builds Stencil?

The README says Stencil is built by the Ionic team. The website describes it as an open source project by Ionic.

Source
Stimulus: What licence does Stimulus use?

The GitHub repository states that Stimulus is released under the MIT licence. It is free to use.

Source
Stencil: Does Stencil work with React, Angular and Vue?

Yes. Components are plain Web Components, and the website provides integration guides for Angular, React and Vue.

Source
Stimulus: Why was Stimulus created?

According to the project's origin page, Basecamp used a mix of jQuery, vanilla JavaScript and object oriented subsystems that were hard to reuse and learn. Stimulus condensed those patterns into a small, consistent framework.

Source
Share

Related pages

Other head to heads