Plays
Plays represent a broad range of software projects that range from individual, granular components to finished applications that users want to distribute on our marketplace.
How it works
Every play is connected directly to a GitHub repository or a subdirectory within one.
When you submit a play, we automatically fetch, format, categorize, and store the code on our servers.
As an alternative, you can supply a playbooks.json file with your preferred setup.
We also prepare the code for deployment within a secure, isolated sandbox.
As the owner, you retain full control and can edit any detail of your play at any time.
Requirements
To ensure a premium experience, plays must meet a few core criteria.
- Visual: Every play should include a cover image or an interactive video demo.
- File Size: The total file size for your play must remain under 100MB.
- Deployment: Your play must successfully deploy and run on our cloud infrastructure.
- Respectful: All plays should be respectful of the broader community and are subject to takedown requests.
- Distribution: You must have the legal right to share, monetize, and distribute the code you are publishing.
Variants
When adding a play, you'll need to select an appropriate variant. This allows us to properly categorize your project and accurately track the credits required per download.
Variant | Credits | Purpose |
|---|---|---|
| Starters | 1 | Basic, unopinionated building blocks needed to launch a new project. |
| Partials | 3 | Specific, modular functionality designed to be dropped into an existing project. |
| Templates | 5 | Advanced, pre-configured building blocks tailored for specific use cases. |
| Stacks | 10 | Layered, stateful solutions that often encompass multiple services or containers. |
| Apps | 20 | Comprehensive, plug-and-play solutions that are nearly ready for production. |
Connections
Plays should maintain a connection to a host GitHub repository or subdirectory at all times. Syncing your play will automatically pull in the latest commits and changes from the host repository. Please note that syncing will temporarily disable your play in the marketplace until it is successfully re-deployed.
Demos
Every play is provisioned with a secure, isolated sandbox for previewing your project. A functional, running demo is required to publish your play to the public marketplace. Each sandbox is allocated 2 vCPUs, 4GB of RAM, and 4GB of disk space. These sandboxes operate in a scalable, serverless environment that is load-balanced based on real-time activity.
Code Explorer
Each play features a built-in code explorer that provides a familiar, intuitive viewing experience similar to the GitHub UI. Before committing credits, users can freely preview the project's high-level file tree and read the accompanying documentation. To view the actual source code within the explorer, users must unlock the play, which deducts credits as a download. Once a play is downloaded, the user enjoys unlimited, lifetime access to explore and utilize the underlying code.
Downloads
Each play includes a variety of built-in tools to easily download, clone, or add the underlying code directly to an existing project. These download events serve as the primary metric we use to calculate and distribute credits for our daily revenue share program.
Visibility
Plays can be explicitly toggled as either public or private. Private plays are hidden from the marketplace and are only accessible to the outside world via a direct, shareable URL. However, as the owner, you will always be able to view and manage all of your plays directly from your private profile.