Getting Started
Overview
Runnable is a powerful framework for building admin workflows with minimal code and zero maintenance.
- You don't need to write any UI code or deploy another frontend.
- Your internal operations stay internal.
- You don't need to build REST or GraphQL endpoints.
- Opinionated UI lets you focus on the business logic.
- Seamless integration with Nest.js and Express.
- Handle complex workflows with conditionals and loops.
Checkout the demo
You can play around with the demo Runnable! And login with any Google creds.
Runnable Mini and Runnable Server
There are two ways to deploy Runnable:
- As a route (e.g.
/admin
) on an existing server like Express or Next.js. - As a standalone server to communicate with many Runnable "clients".
With option 1, Runnable is called Runnable Mini. Runnable Mini is a great way to get started with Runnable and a perfectly viable long-term solution. It's easy to set up and doesn't require any additional infrastructure.
With option 2, Runnable is called Runnable Server. Runnable Server is a great way to build a scalable admin tool. You can connect many clients, for example, a user-service
and an email-service
that can stream their actions to a central location. This is great for services not exposed to the public internet and for services that may be deployed with multiple instances.
Another way to compare their differences are the end user experience. For option 1, we may end up with our domains looking like. https://api.mycompany.com/admin
. But if we end up creating multiple services in our organization each with their own Runnable Mini, our admin portals could be https://api-users.mycompany.com/admin
, https://api-documents.mycompany.com/admin
, etc. So instead we may want to deploy a standalone Runnable Server and stream all the admin workflows with the Runnable SDK to a single service exposed at https://admin.mycompany.com
.
Authentication
Both Runnable Mini and Runnable Server provide a built-in auth solution with various different auth providers to choose from. Checkout Authentication to learn more.
Examples
Example | Source |
---|---|
Runnable Mini + nestjs | GitHub |
Runnable SDK + nestjs | GitHub |