A little help getting settled
Your workspace, connected.
Schist Cloud gives the desktop app a home for files, live edits, and image generation.
Connect the Schist app
- Open the provider settings in Schist and add this server’s public HTTPS domain.
- Continue in your browser and sign in with WorkOS.
- Review the workspace access and choose Connect Schist. Your browser will return to the app.
You can disconnect app sessions at any time in workspace settings. Your saved files stay in the cloud.
Running your own server
The repository includes the server, schema migrations, and a full environment template. Start by copying .env.example to .env.local.
1. Connect Neon
Create a PostgreSQL database, add DATABASE_URL, and run npm run db:migrate.
2. Configure WorkOS
Set your API key, client ID, and a random cookie password. Register /auth/callback as the redirect and /sign-in as the sign-in URL.
3. Connect Stripe
Set your test secret key and run npm run billing:setup. Save the returned price IDs and register /api/webhooks/stripe for checkout, invoice, and subscription events.
4. Add file storage
Use local storage for development. For production, configure a private S3-compatible bucket and its credentials.
5. Add image generation
Set FAL_KEY to enable the FLUX.1 Schnell image provider.
6. Start the server
Run npm run dev locally, or npm run build and npm start for production. Expose the Node server through a proxy with HTTPS and WebSocket support.
The full native client requires HTTPS and WSS, including during local integration testing. Use a TLS reverse proxy or development tunnel. The dashboard works on localhost without credentials as a clearly marked preview.
Built for the Schist protocol
The server provides authentication discovery, rotating app tokens, live folder and bucket queries, signed uploads, and persistent Yjs collaboration. Image generation keeps the original layout-first binary stream.
Read the client specification