SolidJS: The Complete Guide
SolidJS: The Complete Guide
A comprehensive guide to reactive web development with SolidJS and TypeScript
About the Book
SolidJS: The Complete Guide is the most comprehensive resource available for learning SolidJS from the ground up. Whether you’re just curious about reactive UI frameworks or you’re an experienced React or Vue developer looking for a faster, more predictable alternative, this book will guide you step by step.
Starting with the fundamentals of Solid’s reactivity system, you’ll explore signals, effects, memos, computations, and JSX rules before diving into advanced topics like context, stores, directives, asynchronous data handling, routing, and server-side rendering. Each chapter builds on the previous one, ensuring you gain both a conceptual understanding and practical experience.
The book also covers Solid Router and SolidStart, giving you practical insights into building modern, production-ready applications. Through plenty of hands-on examples, you’ll learn routing strategies, data fetching, authentication, server functions, and full-stack development patterns—everything you need to ship real-world SolidJS apps with confidence.
By the end, you’ll be ready to build scalable, reactive, and production-grade applications with SolidJS and SolidStart.
Please scroll down to see the full table of contents and explore the topics covered in detail.
Table of Contents
- 1. Introduction
- Code Examples
- Contact and Feedback
- Requirements
- Trying Solid via Online Playground
- Creating a Project From a Template
- Note For React Developers
- 2. Setting Up a Development Environment
- 3. On SolidJS
- The Problem Solid Solves
- How Solid Works?
- Reactive Data
- Composable UI
- The Advantages of Solid Over Its Alternatives
- 4. How Solid’s Reactive System Works
- Observer Pattern
- The Essence of Reactive Core
- Improving Type Definitions for
createComputation
- Deriving Reactive Values from Signals
- Improving Type Definitions for
- Uses of Computations
- 5. Tracking State with Signals
- Overwriting the Comparison Logic
- Updating Signals
- Deriving Values
- Destructuring Signals
- Batching Updates
- 6. Running Side-Effects with Effects
- Effects Can Be Nested
- Explicit Dependency Tracking
- Opting Out of Tracking
- Handling External Dependencies
- 7. Caching Values with Memos
- 8. Rules of JSX
- Elements Should Be Closed
- Elements Can Be Nested
- Expressions Can Be Used Inside JSX Elements
- Elements Can Have Attributes
- Missing Attribute Values Default to
true
- Comments
- Whitespaces Are Trimmed
- 9. Composing User Interfaces
- Components Should Return a Single Root Element
- Components Accept Data Through Their
props
- Adding Static Types to Components
- Components Can Have Children
- How Components Are Rendered
- Conditional Rendering
- Reactive
props
- Props Should Be Treated as Read-Only
- Destructuring Props Changes the Rendering Order
- Effects Are Executed After Rendering
- Best Practices
- 10. Working with Props
- Passing Data From Parent to Child
- Sharing State Between Children
- Providing Controlled Access to Parent’s State
- Passing Data From Child to Parent
- Destructuring and Spreading Props
- Forwarding Multiple Props at Once
- Validating Props
- 11. Sharing Data Through the Context API
- How Context API Works
- Best Practices
- 12. Component Lifecycle
onMount
onCleanup
- Best Practices
- 13. Accessing DOM Nodes With `ref`
- When
ref
Functions Execute - Forwarding Refs
- Using Refs with External Libraries
- Best Practices
- When
- 14. Working with Computations
createComputed
createRenderEffect
createEffect
createMemo
createDeferred
createReaction
- 15. Handling Errors
ErrorBoundary
catchError
- Handling Asynchronous Errors
- 16. Working with Owners
- Accessing Currently Executing Computation
- Reactivity in Asynchronous Context
- 17. Styling Elements
- Using Inline Styles
- Applying Style Definitions
- Applying Classes Conditionally
- Using the Imperative API
- 18. Reactive Utilities
batch
untrack
on
createRoot
mergeProps
splitProps
- Why Use
splitProps
andmergeProps
?
- Why Use
mapArray
andindexArray
observable
from
startTransition
anduseTransition
- 19. A Better Conditional Rendering
- Show
- Keyed Rendering
- Render Props
Switch
andMatch
- Show
- 20. Working with Lists
For
mapArray
- Index
indexArray
- Selecting Items with Selectors
- 21. Rendering Components Outside the Component Hierarchy
- 22. Managing Complex States with Stores
- Accessing Data
- Updating Stores
- Limitations Related to Reactivity
- Store Utilities
produce
reconcile
unwrap
createMutable
- 23. Abstracting Behavior With Custom Directives
- Extending JSX Type with Custom Directives
- Using Imported Directives
- 24. Working with Asynchronous Data
- Decoupling Fetching From Rendering
- 25. Using Resource API for Data Fetching
- Info Object
- Resource Actions
- Error Handling with Resources
- Display the Error in the UI
- Rethrow During Rendering
- Rethrow inside an Effect or Computated
- Paginated Data with Resources: A Book List Example
- 26. Managing Loading States with Suspense
- 27. Achieving Better Consistency with Transitions
- 28. Coordinating Loading States
- 29. Code Splitting and Lazy Loading
- 30. Handling Events
- Using JSX Attributes with the
on
Prefix - Using JSX Attributes with the
on:
Prefix - Using Custom Properties
- Using Refs
- Using Custom Directives
- Passing Data to Event Handlers
- Using JSX Attributes with the
- 31. Dynamically Rendering Components
- 32. Solid Without JSX
- Solid with Tagged Template Literals
- Solid with Hyperscript
- Drawbacks
- 33. Server Side Rendering
- Issues With Single Page Applications
- SSR: Visible Content From the First Byte
- Three Rendering Approaches for SSR Applications
renderToString
- Synchronous HTML GenerationrenderToStringAsync
- Asynchronous HTML GenerationrenderToStream
- Streaming with Progressive Rendering- Hydration: Breathing Life into Server-Rendered Pages
- Targeting the Server Context
- Targeting the Development Build
- Practical Guide to Server-Rendering
- Separating Application Shell from Client Logic
- Building a Full-Stack App with Express and Solid Router
- 34. Solid Router
- Setting Up Development Environment
- Client-Only Development Environment
- SolidStart Development Environment
- Installing Solid Router
- Routing Strategies
- Anatomy of a URL
- Clean URLs
- Introducing the
Router
Component- Error Handling Considerations
- Defining Routes
- Lazy Loading Route Components
- Matching Dynamic Paths
- Filtering Dynamic Paths
- Optional Parameters
- Catch-All Routes and Handling 404s
- Named Wildcards for Flexibility
- Wildcards Beyond Catch-All Routes
- Use Cases for Wildcard Routes
- Matching Multiple Paths in a Route
- Attaching Metadata
- Layouts
- Rendering Different Layouts Conditionally
- Rendering Different Layouts via Nested Routes
- Nested Routes
- Providing a Shared Layout
- Nested Routes via Configuration
- Alternative Routers
- Hash Mode Router
- Memory Router
- Linking and Navigation
- Using Anchor Elements
- Targeting New Tabs or Frames
- Adding Keyboard Shortcuts with
accesskey
- Security Considerations for Anchor Elements
- Using the
A
Component - Programmatic Navigation
- The
redirect
Function- Using redirect in Queries and Actions
- Single Flight Mutations
throw
vsreturn
- Using Anchor Elements
- Hosting Apps in Subdirectories
- Preloading
- Inside the preload Function
- Manually Preloading with
usePreloadRoute
- Accessing Route Related Data
- Accessing URL Information with
useLocation
- Managing Query Parameters with
useSearchParams
- Extracting Route Parameters with
useParams
- Matching Routes with
useMatch
anduseCurrentMatches
- Accessing URL Information with
- Displaying Transition Indicators
- Intercepting Route Changes with
useBeforeLeave
- Fetching Async Data
- Deduplicated Data Fetching
- Updating Remote Data With Web Forms
- Working With Web Forms
- Collecting User Inputs and Performing Data Updates
- Providing Unique Names For Serialization
- Passing Arguments Directly
- Programmatically Invoking Actions
- Handling Form Errors
- Helper Functions
- Tracking Form Submissions with
useSubmission
anduseSubmissions
- Reactive Forms with Authentication and Validation
- Setting Up Development Environment
- 35. Isomorphic Apps with SolidStart
- Introducing SolidStart
- Project Setup & Configuration
- Project Structure
- Building Navigation with File-Based Routes
- Dynamic Parameters
- Optional Parameters
- Catch-All Routes
- Logical Naming for Cleaner File Organization
- Renaming index.tsx for Discoverability
- Using Folders for Logical Grouping
- Escaping Folder-Based Nesting
- Creating Shared Page Structures with Layouts
- Defining Layouts for Nested Routes
- Escaping Nested Layouts
- Serving Static Assets
- Using
import
Statements
- Using
- Styling Components
- Using Stylesheets
- Using CSS Modules
- CSS-in-JS
- Data Exchange Between the Server and Client
- Basic Data Fetching: API Endpoints
- Idiomatic Data Fetching: Server Functions
- Performing Server-Side Mutations: Server Actions
- Caching Data for Request Deduplication
- Preloading Data
- Pre-rendering Routes
- Registering API Endpoints
- Using the file router API
- Using application configuration
- Using a Middleware
- Using the
GET
function
- Accessing Server Events
- Managing
<head>
Elements - Setting HTTP Headers and Status Codes
- Setting HTTP Headers
- Setting HTTP Status Codes
- Creating Client-Only Components
- Building Echoes: A Quote Management App with
SolidStart
- Project Setup
- Application Structure and Routes
- Route Organization
- Protected Routes
- Public Routes
- Application Layout
- Styling
- Error Handling
- Fetching Data
- Updating Data
- Authentication and Authorization
- Notifications and Confirmation Dialogs
- Mounting the Client-Only Layers
- Notifications: Decoupled, Event-Driven Toasts
- Confirmation Dialogs: Explicit Consent for Destructive Actions
- Notifications and Confirmation Dialogs
- Closing Thoughts
- A1. Setting Development Environment Using Webpack
- Install Dependencies
- Configuring Webpack
- Configure the Webpack Dev Server
- Add TypeScript Support
- Add Eslint Support
- Create a Basic Application
- About the Author
The Leanpub 60 Day 100% Happiness Guarantee
Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.
Now, this is technically risky for us, since you'll have the book or course files either way. But we're so confident in our products and services, and in our authors and readers, that we're happy to offer a full money back guarantee for everything we sell.
You can only find out how good something is by trying it, and because of our 100% money back guarantee there's literally no risk to do so!
So, there's no reason not to click the Add to Cart button, is there?
See full terms...
Earn $8 on a $10 Purchase, and $16 on a $20 Purchase
We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.
(Yes, some authors have already earned much more than that on Leanpub.)
In fact, authors have earnedover $14 millionwriting, publishing and selling on Leanpub.
Learn more about writing on Leanpub
Free Updates. DRM Free.
If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).
Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.
Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.
Learn more about Leanpub's ebook formats and where to read them