Skip to main content

Connect Solid Apps

JSS works with existing Solid applications.

SolidOS / Mashlib

Enable the data browser:

jss start --mashlib-cdn --conneg

Browse to any resource in a web browser to see the Mashlib UI.

Solid-OIDC Apps

For apps that require Solid-OIDC login:

jss start --idp --conneg

Create a user with email/password:

curl -X POST http://localhost:3000/.pods \
-H "Content-Type: application/json" \
-d '{"name": "alice", "email": "alice@example.com", "password": "secret"}'

The app can discover the IdP at /.well-known/openid-configuration.

Common Apps

AppRequirementsNotes
SolidOS--conneg, --mashlib-cdnFull data browser
Solid File Client--connegFile management
Penny--idp, --connegPod browser

Troubleshooting

App can't parse responses

Enable content negotiation:

jss start --conneg

Login doesn't work

Enable the Identity Provider:

jss start --idp

CORS errors

JSS has CORS enabled by default. If issues persist, check your reverse proxy configuration.