How do I handle async actions like AJAX calls in Thermite?

Use the performAction function with coroutines; for example, lift an Aff computation and use cotransform to update state multiple times, as shown in the README's server increment example with getIncrementValueFromServer.

What's the difference between Thermite and purescript-react?

Thermite is a minimal wrapper that abstracts common React APIs for a functional, composable approach, while purescript-react provides direct bindings to React, offering full control but requiring more verbose code for similar tasks.

How can I compose components with different state types in Thermite?

Use combinators like focus with lenses and prisms to embed subcomponents; for instance, combine states with Tuple and actions with Either, as demonstrated in the focus example with spec1 and spec2.

Is Thermite suitable for large-scale applications?

Yes, its composable design via optics and monoidal specs supports scalable architecture, but managing complexity may require careful type design and occasional use of purescript-react for edge cases not covered by Thermite.

How do I integrate third-party React components with Thermite?

Since Thermite wraps React, you can use purescript-react directly to embed JavaScript components, but this requires bridging functional and imperative code, adding integration overhead and potential type safety issues.

Thermite vs Halogen: which is better for PureScript UIs?

Thermite is closer to React with a functional layer, ideal for teams familiar with React; Halogen is a pure functional UI library with a different architecture. Choose based on your preference for React-like patterns versus a more abstract FP approach.

How to manage global state in a Thermite app?

Thermite focuses on component-local state; for global state, you need to lift state up using parent components or integrate with external state management libraries compatible with PureScript, as Thermite does not provide built-in solutions.

purescript-thermite — PureScript React Wrapper

What is purescript-thermite?

Thermite is a PureScript library that wraps React to provide a clean, functional API for building user interfaces. It simplifies React usage by exposing commonly needed features through a declarative component model based on actions and states, while allowing direct access to purescript-react for advanced cases.

Target Audience

PureScript developers building interactive web applications who want a functional, composable approach to React component development without the full complexity of React's API.

Value Proposition

Developers choose Thermite for its minimal abstraction over React, strong emphasis on composition via optics, and seamless integration with PureScript's type system, making it ideal for building maintainable UIs in a functional style.

A simple PureScript wrapper for React

Use Cases

Best For

Building interactive UIs in PureScript with a functional programming approach
Creating composable React components using lenses and prisms for state and action management
Implementing asynchronous action handlers with coroutines for state updates
Developing modular component systems where subcomponents can be combined monoidally
Embedding collections of subcomponents with indexed state and actions via `foreach`
Handling optional child components with `Maybe` states using the `split` combinator

Not Ideal For

Projects requiring direct access to React's full API, including hooks and lifecycle methods not covered by Thermite's abstraction
Teams unfamiliar with functional programming concepts like lenses, prisms, and coroutines, as Thermite relies heavily on these
Applications that depend extensively on JavaScript libraries without PureScript bindings, due to Thermite's PureScript-specific nature
Rapid prototyping where a more opinionated UI framework with pre-built components would speed up initial development

Pros & Cons

Pros

Declarative Component Model

Enforces clear separation of concerns with actions, states, and pure rendering functions, as shown in the counter example where rendering and action handling are defined separately.

Composition via Optics

Uses lenses and prisms like focus, split, and foreach to flexibly embed and combine components, enabling modular design as demonstrated in the combining components section.

Asynchronous Action Handling

Supports complex workflows with coroutines that can emit multiple state updates, ideal for AJAX calls or websockets, illustrated in the performAction example with server-side increments.

Monoidal Spec Composition

Allows Spec types to be combined using Semigroup and Monoid instances for easy modular assembly, reducing boilerplate in component design.

Cons

Limited React API Coverage

Does not expose all React features, requiring fallback to purescript-react for specialized use cases, which adds complexity and potential integration hurdles.

Steep Learning Curve

Requires understanding of advanced functional programming concepts like optics and coroutines, which can be a barrier for developers new to PureScript or FP.

Ecosystem Constraints

Tied to the PureScript ecosystem, which has a smaller community and fewer libraries compared to JavaScript, limiting third-party integration options and support resources.

Frequently Asked Questions

What is purescript-thermite?

Target Audience

PureScript developers building interactive web applications who want a functional, composable approach to React component development without the full complexity of React's API.

Value Proposition

Use Cases

Best For

Building interactive UIs in PureScript with a functional programming approach
Creating composable React components using lenses and prisms for state and action management
Implementing asynchronous action handlers with coroutines for state updates
Developing modular component systems where subcomponents can be combined monoidally
Embedding collections of subcomponents with indexed state and actions via `foreach`
Handling optional child components with `Maybe` states using the `split` combinator

Not Ideal For

Projects requiring direct access to React's full API, including hooks and lifecycle methods not covered by Thermite's abstraction
Teams unfamiliar with functional programming concepts like lenses, prisms, and coroutines, as Thermite relies heavily on these
Applications that depend extensively on JavaScript libraries without PureScript bindings, due to Thermite's PureScript-specific nature
Rapid prototyping where a more opinionated UI framework with pre-built components would speed up initial development

Pros & Cons

Pros

Declarative Component Model

Enforces clear separation of concerns with actions, states, and pure rendering functions, as shown in the counter example where rendering and action handling are defined separately.

Composition via Optics

Uses lenses and prisms like focus, split, and foreach to flexibly embed and combine components, enabling modular design as demonstrated in the combining components section.

Asynchronous Action Handling

Supports complex workflows with coroutines that can emit multiple state updates, ideal for AJAX calls or websockets, illustrated in the performAction example with server-side increments.

Monoidal Spec Composition

Allows Spec types to be combined using Semigroup and Monoid instances for easy modular assembly, reducing boilerplate in component design.

Cons

Limited React API Coverage

Does not expose all React features, requiring fallback to purescript-react for specialized use cases, which adds complexity and potential integration hurdles.

Steep Learning Curve

Requires understanding of advanced functional programming concepts like optics and coroutines, which can be a barrier for developers new to PureScript or FP.

Ecosystem Constraints

Tied to the PureScript ecosystem, which has a smaller community and fewer libraries compared to JavaScript, limiting third-party integration options and support resources.

Frequently Asked Questions

purescript-thermite

What is purescript-thermite?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?

purescript-thermite

What is purescript-thermite?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?