[Request]: Cover native/mobile rendering (`solid-js/universal`) - the docs have no answer to "can I build a mobile app with Solid?"

Open
#1,636 1 comment 0 reactions 1 assignee View on GitHub

@LadyBluenotes is already working on this.

Since Aug 22, 2026.

Assessment

This issue has not been assessed yet.

Description

pending review
What is this request related to?

Request

📋 Suggested

https://docs.solidjs.com/quick-start
https://docs.solidjs.com/reference/rendering/render
(no existing page covers this — that's the point of the request)

📋 General description or bullet points

The gap

There is currently nothing in the docs about rendering Solid anywhere other than the DOM. A search
across solid-docs for solid-js/universal, createRenderer, custom renderer, React Native,
Capacitor and NativeScript returns zero hits in src/routes/**. So:

  • "Can I build a mobile app with Solid?" — a very common first question — has no answer in the docs.
  • solid-js/universal (createRenderer) is a public, shipped Solid API with no reference page
    and no mention anywhere in the docs. Right now you have to read packages/solid/universal/ in the
    Solid repo to learn it exists.

Prior art in neighbouring frameworks

Both Svelte and Vue answer this in their own docs, and both did it recently:

Each covers two distinct paths: wrapping an SPA (Capacitor / Tauri) and rendering real native
views
through a custom renderer.

Concrete proposal

A short page under Guides (e.g. "Building for mobile"), or an FAQ entry if you'd rather introduce
one, covering:

  1. Wrapping a Solid SPA — Capacitor (there are official
    ionic-team/capacitor-solidjs-templates)
    and Tauri.
  2. Real native views via solid-js/universalcreateRenderer lets Solid drive a non-DOM host.
    Worth a paragraph on its own merit, independent of any particular library, since the API is
    undocumented today.

Optionally a follow-up reference page for solid-js/universal under reference/rendering/.

Disclosure + offer

I maintain Symbiote Native, which has a
solid-js/universal adapter (@symbiote-native/solid) driving React Native's Fabric renderer with
React out of the path, running on device. So I have an obvious interest here and I'm flagging it up
front. I'm happy to write the PR, and equally happy for it to name no specific library at all — the
missing coverage of solid-js/universal and of the mobile question stands either way.

One data point on how thin the current coverage is: the only mobile-related entry on solidjs.com's
resources page, solid-native, is flagged
maintained: false in solid-site's own data.

🖥️ Reproduction of code samples in StackBlitz

No response

Dominant language
MDX
Stars
292
Forks
361
Avg merge
7h 51m
Merged PRs (30d)
1

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from solidjs/solid-docs

All issues in solidjs/solid-docs

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.