--- title: "Introduction to the Bring Your Own (BYO) Framework" slug: "introduction-to-the-bring-your-own-byo-framework" updated: 2025-09-26T06:26:13Z published: 2025-09-26T06:26:13Z canonical: "docs.unqork.io/introduction-to-the-bring-your-own-byo-framework" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.unqork.io/llms.txt > Use this file to discover all available pages before exploring further. # Introduction to the Bring Your Own (BYO) Framework > [!NOTE] > The Bring Your Own Assets feature is currently in open beta. Please contact your Unqork representative for more details and access. ## Overview The **BYO (Bring Your Own)** empowers Creators to extend the Unqork platform with custom-built functionality that goes beyond Unqork's standard configuration. By packaging and deploying custom component, operation, or event logic in a structured, validated format, developers gain full control over application behavior while maintaining compatibility with Unqork’s runtime. With the BYO framework, you can create custom assets like components, events, and operations. These custom assets are then available for use by all Creators in your Unqork Designer Platform environment. > [!WARNING] > The Bring Your Own framework is intended for developers who have a strong understanding of the Unqork Designer Platform and JavaScript. ## Understanding the BYO End-to-End Flow The BYO end-to-end process begins by creating a package archive that includes the implementation (`.js`) and `manifest.json` files, which define the metadata and configuration contracts. After installing a package in your Unqork environment, the Unqork Designer Platform performs validation to ensure the structure and contents are valid. After validation, the package is extracted and its files are uploaded to Unqork's object storage solution (Amazon S3). Then, the package is served through Unqork's CDN (Content Delivery Network), making it accessible to browser-based applications. Next, the Unqork platform parses the `manifest.json` to extract metadata used in the display and configuration of custom components in the Designer platform's visual interface. At runtime, during the initial page load of the application, all JavaScript files from the package load. Doing so ensures the custom functionality is available and ready to render as part of the application configuration. [![A static image displaying the Bring Your Own Framework](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/byoFramework_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A59Z&se=2026-11-07T18%3A57%3A59Z&sr=c&sp=r&sig=DZqDbe%2FLavRI3ig%2BpDYY9j39fxkGjWZSEj%2F%2BnntrcHU%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/byoFramework.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A59Z&se=2026-11-07T18%3A57%3A59Z&sr=c&sp=r&sig=DZqDbe%2FLavRI3ig%2BpDYY9j39fxkGjWZSEj%2F%2BnntrcHU%3D) ## Get Started Use the links below to learn how the BYO framework functions, including: - How to extend the Unqork platform using custom BYO packages. - The required structure and contents of a valid BYO package, including manifest.json and compiled JavaScript. - A working knowledge of the Runtime Engine API and how your component interacts with state and events. - How to create, configure, and register custom components for use in the Unqork Designer. - End-to-end visibility into the BYO life cycle—from development to deployment in a live application. ## BYO Documentation ### [Create a BYO Package](/v1/docs/bring-your-own-byo-create-a-package) Discover the structure and content of a BYO Package ### [Understanding the manifest.json File](/v1/docs/bring-your-own-byo-understanding-the-manifestjson-file) Learn about the file's specification, component and event definitions. ### [Understanding the BYO Runtime Engine API](/v1/docs/bring-your-own-byo-understanding-runtime-engine-api) Discover the interface between your custom BYO components and the Unqork platform. ### [Custom Component](/v1/docs/bring-your-own-byo-custom-component) Understand the state, interface, and events of a custom component. ### [Custom Component SDK](/v1/docs/bring-your-own-byo-component-sdk-software-development-kit) Extend component functionality in the Unqork Designer Platform. ### [Custom Events](/v1/docs/bring-your-own-byo-custom-events) Learn more about creating custom events for use in the Operations Builder. ## [Custom Operations](/v1/docs/bring-your-own-byo-custom-operations) Learn more about creating custom operations for use in the Operations Builder.. ### [Event Payloads](/v1/docs/bring-your-own-byo-726-event-payloads) Learn more about viewing and using event payloads with the Operations Builder. ### [BYO Implementation Examples](/v1/docs/bring-your-own-byo-726-implementation-examples) Discover examples of component implementation using the Unqork Designer Platform. ### [Custom Assets Administration](/v1/docs/custom-assets-administration) Upload and view BYO custom assets for the environment. ### [BYO Best Practices](/v1/docs/best-practices-bring-your-own-byo-framework) Learn about best practices for implementing and using BYO assets. ### [BYO General FAQ](/v1/docs/bring-your-own-byo-general-faq-frequently-asked-questions) Learn about the Bring Your Own Framework and discover frequently asked questions. Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform. JavaScript is an object-oriented computer programming language. It is most-commonly used for interactive effects in the browser. APIs (application programming interfaces) are a set of protocols and definitions developers use to build and integrate application software. APIs act as the connective tissue between products and services.