solidjs / solidjs/solid-docs

[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.

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

Description

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

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.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.