Boxo Miniapps are native-like web apps that can be seamlessly integrated and launched within third-party native apps (Host Apps). To deliver the best user experience, they should be fast, simple, and efficient. These guidelines aim to help you create quick-loading, high-performance, and consistent user experiences across both Boxo miniapps and host apps. By following these principles, you can ensure smooth functionality, usability, and seamless interaction between the miniapp and host app environments.Miniapp should work equally well on all supported platformsBoxo iOS SDK is compatible with mobile clients running iOS 11.0 or higher. Similarly, Boxo Android SDK is designed to work with mobile clients running Android 5.0 (Lollipop) or higher. These versions ensure compatibility and allow users to leverage Boxo’s features across a wide range of devices.If service functionality is restricted due to factors such as geographical location, operating system version, or mobile app version, display a dedicated screen that clearly communicates the reason for the limitation. This will help users understand why the application is unavailable or why they cannot proceed further.When testing the service, ensure thorough testing across all planned platforms. Additionally, we will soon release Boxo UI guidelines, which will include Boxo UI components for both Android and iOS apps, to help standardize and streamline development.
Mini header
The upper right corner is occupied by native Boxo menu buttons. Do not place your navigation elements in this area. Developers cannot customize their content. When you need to add interactive elements around this menu, test and check the functionality and interactions of the elements with the native Boxo elements.Utilise only green space in your UI/UXFor the same reason, the title should be short or placed under the buttons so it doesn’t come too close to the native menu buttons. Be extra careful with the ios platform as as the headers are located in the center, leaving even less space for creativity. Header image Title should be short and meaningful.The title of each page should be meaningful. There is no need to place the name of the miniapp on each page, rather ensure it reflects the essence of the specific page.
Hostapp emulator
To test your miniapp, you can install our Hostapp emulator chrome extension that emulates the native app’s behavior. You can see which API events are received from the miniapp and try sending different API events to test the miniapp’s behavior.
WARNING
The Host app emulator is under active development and not all API events are supported. Please stay tuned for more updates.
Take care of navigation
You can add navigation operations within the page based on your design requirements. There should be consistency in the navigation operations across all pages to facilitate forward and backward movements. This means using the same back button or logical tab navigation bar when moving between screens.Use native icons for navigation. Make it look native.Use the hardware back key on Android devices. On Android devices, clicking the Back button returns the user to previous screen action in the WebView. By pressing this button, the host app will return the user to the previous page of the host app or close the miniapp if it is impossible to return. To prevent the user from exiting your miniapp, make use of java scripts available routing libraries.Make sure that input fields are saved when moving between screens. For example, if the user fills in the information for booking tickets on three different screens and suddenly realizes that the input on the first page was incorrect. Do not force the user to re-enter all the details.If for some reason the transition between screens takes a considerable amount of time (for example, the miniapp uses a complex search query), use loaders or spinners to show the user that the miniapp is active and working and there is no need to leave.
Use convenient buttons and readable fonts.
When developing a miniapp, it is important to remember that the Boxo iOS and Android SDK are used by many users with a variety of devices: the application should be equally convenient on screens of any size.Fonts should be medium sized adaptive to the screen size of the device.Use system fonts whenever in doubt.The upper right corner of the miniapp is always occupied by the native menu buttons, so avoid using this area to place any of your buttons (like closing photo screen).Navigation icons, buttons, and everything that can be tapped should be located in such a way so that the user does not accidentally touch the native buttons in the upper right corner and open a menu or close the miniapp.It is worth making sure that the native buttons do not overlap with the design/navigation elements in the application.Do not place long texts of multiple lines within buttons.The layout of the miniapp should work equally well on all platforms from the standard iPhone 5s with a small screen as well as the Galaxy Note with a large diagonal.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Boxo Documentation","colors":{"primary":"#171717","light":"#FFFFFF","dark":"#171717"},"logo":{"light":"https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/logo/light.svg?fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=d1b1b810a109009c923476fe558aedaf","dark":"https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/logo/dark.svg?fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=aadd01d78b28949157f344143d98408d"},"favicon":"https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/favicon.svg?fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=5016266bd7873b2367310f8a9f7736df","navbar":{"links":[{"href":"mailto:support@boxo.io","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/boxohq","github":"https://github.com/Appboxo","linkedin":"https://sg.linkedin.com/company/boxoplatform"}},"styling":{"codeblocks":"system","latex":false},"integrations":{"intercom":{"appId":"jybbc08f"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"boxo","hasAudioNarration":false,"actualSubdomain":"boxo","customDomains":[],"gitSource":{"type":"github","owner":"appboxo","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae2ec6d6da6e957d16c7eea","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Miniapps","count":18},{"language":"default","tag":"Host Apps","count":14},{"language":"default","tag":"Welcome","count":10},{"language":"default","tag":"Changelog","count":6},{"language":"default","tag":"White Label Miniapps","count":6},{"language":"default","tag":"API Reference","count":3}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@appboxo.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"miniapp/Design","slug":"/miniapp/Design","pageMetadata":{"title":"Design - UI/UX of Miniapps","description":null,"icon":"","href":"/miniapp/Design"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,em:`em`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,OptimizedImage,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Boxo Miniapps are native-like web apps that can be seamlessly integrated and launched within third-party native apps (Host Apps). To deliver the best user experience, they should be fast, simple, and efficient. These guidelines aim to help you create quick-loading, high-performance, and consistent user experiences across both Boxo miniapps and host apps. By following these principles, you can ensure smooth functionality, usability, and seamless interaction between the miniapp and host app environments.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Miniapp should work equally well on all supported platforms`})}),`\n`,_jsx(_components.p,{children:`Boxo iOS SDK is compatible with mobile clients running iOS 11.0 or higher. Similarly, Boxo Android SDK is designed to work with mobile clients running Android 5.0 (Lollipop) or higher. These versions ensure compatibility and allow users to leverage Boxo’s features across a wide range of devices.`}),`\n`,_jsx(_components.p,{children:`If service functionality is restricted due to factors such as geographical location, operating system version, or mobile app version, display a dedicated screen that clearly communicates the reason for the limitation. This will help users understand why the application is unavailable or why they cannot proceed further.`}),`\n`,_jsx(_components.p,{children:`When testing the service, ensure thorough testing across all planned platforms. Additionally, we will soon release Boxo UI guidelines, which will include Boxo UI components for both Android and iOS apps, to help standardize and streamline development.`}),`\n`,_jsx(Heading,{level:`2`,id:`mini-header`,children:`Mini header`}),`\n`,_jsx(_components.p,{children:`The upper right corner is occupied by native Boxo menu buttons. Do not place your navigation elements in this area. Developers cannot customize their content. When you need to add interactive elements around this menu, test and check the functionality and interactions of the elements with the native Boxo elements.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Boxo-Working-Area.png?fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=aa0cbf2e1fd6c5177179c0003a21de67`,alt:`Utilies only greens space in your UI/UX`,\"data-og-width\":`1880`,width:`1880`,\"data-og-height\":`1280`,height:`1280`,\"data-path\":`images/Boxo-Working-Area.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Boxo-Working-Area.png?w=280\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=08ffba09ef25edd92c5104b677717880 280w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Boxo-Working-Area.png?w=560\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=25a33d3b64152897cad60dd09de25207 560w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Boxo-Working-Area.png?w=840\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=2e9237d8745cef4a377b4a2bc56ec860 840w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Boxo-Working-Area.png?w=1100\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=789f6f834d4fab88c4fab0e5e5602bb6 1100w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Boxo-Working-Area.png?w=1650\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=201ba1c2d62323d781cf2a4e543bfdd0 1650w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Boxo-Working-Area.png?w=2500\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=709cc9a08fd03ba402de8cedbeed1777 2500w`}),`\n`,_jsx(_components.p,{children:_jsx(_components.em,{children:`Utilise only green space in your UI/UX`})}),`\n`,_jsx(_components.p,{children:`For the same reason, the title should be short or placed under the buttons so it doesn’t come too close to the native menu buttons. Be extra careful with the ios platform as as the headers are located in the center, leaving even less space for creativity. Header image Title should be short and meaningful.`}),`\n`,_jsx(_components.p,{children:`The title of each page should be meaningful. There is no need to place the name of the miniapp on each page, rather ensure it reflects the essence of the specific page.`}),`\n`,_jsx(Heading,{level:`2`,id:`hostapp-emulator`,children:`Hostapp emulator`}),`\n`,_jsxs(_components.p,{children:[`To test your miniapp, you can install our `,_jsx(_components.a,{href:`https://chrome.google.com/webstore/detail/appboxohostappemulator/aacgglamlcapoldmjiindjbpflkjpbpp`,children:`Hostapp emulator`}),` chrome extension that emulates the native app’s behavior. You can see which API events are received from the miniapp and try sending different API events to test the miniapp’s behavior.`]}),`\n`,_jsxs(Warning,{children:[` `,_jsx(_components.strong,{children:`WARNING`}),`\nThe Host app emulator is under active development and not all API events are supported. Please stay tuned for more updates. `]}),`\n`,_jsx(Heading,{level:`2`,id:`take-care-of-navigation`,children:`Take care of navigation`}),`\n`,_jsx(_components.p,{children:`You can add navigation operations within the page based on your design requirements. There should be consistency in the navigation operations across all pages to facilitate forward and backward movements. This means using the same back button or logical tab navigation bar when moving between screens.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Navigation-Bars.png?fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=58fc2afd3e74029d72b966a398244d2c`,alt:`NavigationBar`,\"data-og-width\":`1880`,width:`1880`,\"data-og-height\":`840`,height:`840`,\"data-path\":`images/Navigation-Bars.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Navigation-Bars.png?w=280\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=b172a4e7195734587a91edc8850937c4 280w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Navigation-Bars.png?w=560\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=b3d7966cb86fa209771821dda6473c0b 560w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Navigation-Bars.png?w=840\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=050786b1b743a6678700314c34c6b72a 840w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Navigation-Bars.png?w=1100\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=b4d68ec21ff6095dfdcecdaa376e3c32 1100w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Navigation-Bars.png?w=1650\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=0ea8d03fc787a05dc869a8fe71963a99 1650w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Navigation-Bars.png?w=2500\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=c7c0dcaa18e7ed4b12af99c97569f31b 2500w`}),`\n`,_jsx(_components.p,{children:_jsx(_components.em,{children:`Use native icons for navigation. Make it look native.`})}),`\n`,_jsx(_components.p,{children:`Use the hardware back key on Android devices. On Android devices, clicking the Back button returns the user to previous screen action in the WebView. By pressing this button, the host app will return the user to the previous page of the host app or close the miniapp if it is impossible to return. To prevent the user from exiting your miniapp, make use of java scripts available routing libraries.`}),`\n`,_jsx(_components.p,{children:`Make sure that input fields are saved when moving between screens. For example, if the user fills in the information for booking tickets on three different screens and suddenly realizes that the input on the first page was incorrect. Do not force the user to re-enter all the details.`}),`\n`,_jsx(_components.p,{children:`If for some reason the transition between screens takes a considerable amount of time (for example, the miniapp uses a complex search query), use loaders or spinners to show the user that the miniapp is active and working and there is no need to leave.`}),`\n`,_jsx(Heading,{level:`2`,id:`use-convenient-buttons-and-readable-fonts`,children:`Use convenient buttons and readable fonts.`}),`\n`,_jsx(_components.p,{children:`When developing a miniapp, it is important to remember that the Boxo iOS and Android SDK are used by many users with a variety of devices: the application should be equally convenient on screens of any size.`}),`\n`,_jsx(_components.p,{children:`Fonts should be medium sized adaptive to the screen size of the device.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Fonts.png?fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=e81d72f08b21ab051c4e146c58948a57`,alt:`Fonts`,\"data-og-width\":`1880`,width:`1880`,\"data-og-height\":`840`,height:`840`,\"data-path\":`images/Fonts.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Fonts.png?w=280\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=3ae5946eef084b2ab540b2017aedfec6 280w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Fonts.png?w=560\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=af973fb4efcff772e260331415da2262 560w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Fonts.png?w=840\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=dd969e890070124be564251f0d3b9097 840w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Fonts.png?w=1100\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=47d3c152c076aaa3511f7b6c461c6048 1100w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Fonts.png?w=1650\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=19bfeb4de8425ffcf0a2dc6b16b2dd33 1650w, https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/images/Fonts.png?w=2500\u0026fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=8797fd97834f5a866d739b842937b71b 2500w`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Use system fonts whenever in doubt.`})}),`\n`,_jsx(_components.p,{children:`The upper right corner of the miniapp is always occupied by the native menu buttons, so avoid using this area to place any of your buttons (like closing photo screen).`}),`\n`,_jsx(_components.p,{children:`Navigation icons, buttons, and everything that can be tapped should be located in such a way so that the user does not accidentally touch the native buttons in the upper right corner and open a menu or close the miniapp.`}),`\n`,_jsx(_components.p,{children:`It is worth making sure that the native buttons do not overlap with the design/navigation elements in the application.`}),`\n`,_jsx(_components.p,{children:`Do not place long texts of multiple lines within buttons.`}),`\n`,_jsx(_components.p,{children:`The layout of the miniapp should work equally well on all platforms from the standard iPhone 5s with a small screen as well as the Galaxy Note with a large diagonal.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Design - UI/UX of Miniapps","description":null,"icon":"","href":"/miniapp/Design"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Mini header","slug":"mini-header","depth":2,"children":[]},{"title":"Hostapp emulator","slug":"hostapp-emulator","depth":2,"children":[]},{"title":"Take care of navigation","slug":"take-care-of-navigation","depth":2,"children":[]},{"title":"Use convenient buttons and readable fonts.","slug":"use-convenient-buttons-and-readable-fonts","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"boxo","siteName":"Boxo Documentation","title":"Design - UI/UX of Miniapps - Boxo Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T11:14:48.237Z","originalFileLocation":"miniapp/Design.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Boxo Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/boxo/eOUJMcFBSjsV305s/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/boxo/eOUJMcFBSjsV305s/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/boxo/eOUJMcFBSjsV305s/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/boxo/eOUJMcFBSjsV305s/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/boxo/eOUJMcFBSjsV305s/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/boxo/eOUJMcFBSjsV305s/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/boxo/eOUJMcFBSjsV305s/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/boxo/eOUJMcFBSjsV305s/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/boxo/eOUJMcFBSjsV305s/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Design - UI/UX of Miniapps - Boxo Documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Boxo Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://boxo.mintlify.app/miniapp/Design\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://boxo.mintlify.site/_mintlify/api/og/v2?division=Miniapps\u0026amp;title=Design+-+UI%2FUX+of+Miniapps\u0026amp;theme=03af591456f88e727c750e99\u0026amp;signature=a7e75f0bef7bcbcdac3fb72590757bf6397b96d6c9e2bf68d6bd321a095c20aa\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Design - UI/UX of Miniapps - Boxo Documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://boxo.mintlify.site/_mintlify/api/og/v2?division=Miniapps\u0026amp;title=Design+-+UI%2FUX+of+Miniapps\u0026amp;theme=03af591456f88e727c750e99\u0026amp;signature=a7e75f0bef7bcbcdac3fb72590757bf6397b96d6c9e2bf68d6bd321a095c20aa\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/boxo/eOUJMcFBSjsV305s/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Boxo Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#171717\">\u003clink data-mint-head rel=\"canonical\" href=\"https://boxo.mintlify.app/miniapp/Design\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/miniapp/Design.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://boxo.mintlify.app/#organization\",\"name\":\"Boxo Documentation\",\"url\":\"https://boxo.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/boxo/3dTfSQuOOiy3lc57/logo/light.svg?fit=max\u0026auto=format\u0026n=3dTfSQuOOiy3lc57\u0026q=85\u0026s=d1b1b810a109009c923476fe558aedaf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://boxo.mintlify.app#website\",\"name\":\"Boxo Documentation\",\"url\":\"https://boxo.mintlify.app\",\"publisher\":{\"@id\":\"https://boxo.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://boxo.mintlify.app/miniapp/Design#webpage\",\"url\":\"https://boxo.mintlify.app/miniapp/Design\",\"name\":\"Design - UI/UX of Miniapps\",\"dateModified\":\"2026-10-28T11:14:48.237Z\",\"isPartOf\":{\"@id\":\"https://boxo.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://boxo.mintlify.app/miniapp/Design#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://boxo.mintlify.app/miniapp/Design#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Miniapps\",\"item\":\"https://boxo.mintlify.app/miniapp/Intro\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Design - UI/UX of Miniapps\",\"item\":\"https://boxo.mintlify.app/miniapp/Design\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://boxo.mintlify.app/miniapp/Design#article\",\"headline\":\"Design - UI/UX of Miniapps\",\"name\":\"Design - UI/UX of Miniapps\",\"url\":\"https://boxo.mintlify.app/miniapp/Design\",\"mainEntityOfPage\":{\"@id\":\"https://boxo.mintlify.app/miniapp/Design#webpage\"},\"dateModified\":\"2026-10-28T11:14:48.237Z\",\"publisher\":{\"@id\":\"https://boxo.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://boxo.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Boxo Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Boxo Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/miniapp/Design.md","siteName":"Boxo Documentation","nav":{"global":null,"tabs":[{"tab":"Welcome","pages":[{"group":"Welcome","pages":[{"title":"Start Building","mode":"wide","href":"/main/homepage"},{"title":"Authentication","href":"/authentication"}]},{"group":"Host Apps","pages":[{"title":"Introduction","icon":"","mode":"wide","href":"/host-apps/introduction"},{"title":"Key Principles","icon":"","href":"/host-apps/keyPrinciples"},{"title":"Getting Started","href":"/host-apps/GettingStarted"},{"title":"Boxo SDK","href":"/host-apps/BoxoSDK"},{"title":"Custom Events System","icon":"","href":"/host-apps/CES"},{"title":"Boxo Connect","href":"/host-apps/BoxoConnect"},{"title":"Boxo Payments","icon":"","href":"/host-apps/BoxoPayments"},{"title":"Deeplinks","icon":"","href":"/host-apps/DeepLink"},{"title":"Error Codes","icon":"","href":"/host-apps/ErrorCodes"},{"title":"Android / iOS Sample Host App","icon":"","href":"/host-apps/SampleHostApp"},{"title":"Testing Host App","icon":"","href":"/host-apps/Testing"},{"title":"Security measures","icon":"","href":"/host-apps/SecurityMeasures"},{"title":"Request Signaturing","icon":"","href":"/host-apps/Signaturing"}]},{"group":"Miniapps","pages":[{"title":"Introduction","icon":"","mode":"wide","href":"/miniapp/Intro"},{"title":"Key Principles","icon":"","href":"/miniapp/KeyP"},{"title":"Getting Started","description":null,"icon":"","href":"/miniapp/GettingStarted"},{"title":"Design - UI/UX of Miniapps","icon":"","href":"/miniapp/Design"},{"title":"Miniapp Settings","description":null,"icon":"","href":"/miniapp/Settings"},{"title":"Miniapp Performance","icon":"","href":"/miniapp/Perf"},{"title":"Boxo Connect","href":"/miniapp/Connect"},{"title":"Boxo Payments","icon":"","href":"/miniapp/Payment"},{"title":"Error Codes","icon":"","href":"/miniapp/Error"},{"title":"Native Components","href":"/miniapp/Native"},{"title":"Miniapp Analytics","icon":"","href":"/miniapp/Analytics"},{"title":"Custom Events","icon":"","href":"/miniapp/CES"},{"title":"Miniapp White-labeling","icon":"","href":"/miniapp/WhiteLabel"},{"title":"Testing","icon":"","href":"/miniapp/Testing"},{"title":"Security Measures","icon":"","href":"/miniapp/Security"},{"title":"Request Signaturing","icon":"","href":"/miniapp/Signaturing"}]},{"group":"API References","pages":[{"title":"Events API Reference","icon":"","href":"/MiniApp API Reference/EventsAPI"},{"title":"API Reference","icon":"","href":"/MiniApp API Reference/APIReference"},{"title":"Authentication API Reference","icon":"","href":"/MiniApp API Reference/AuthenticationAPIRef"}]},{"group":"Standard Events","pages":[{"title":"Standard Events","icon":"arrows-left-right","href":"/events/introduction"},{"title":"Refunds","icon":"rotate-left","href":"/events/refunds"}]},{"group":"White Label Miniapps","pages":[{"title":"eSIM Integration","icon":"sim-card","href":"/mini-apps/esim/integration"},{"title":"Lounges Integration","icon":"couch","href":"/mini-apps/lounges/integration"},{"title":"Fast Track Integration","icon":"person-walking","href":"/mini-apps/fast-track/integration"},{"title":"Flights Integration","icon":"plane","href":"/mini-apps/flights/integration"},{"title":"Hotels Integration","icon":"hotel","href":"/mini-apps/hotels/integration"},{"title":"Airport Rides Integration","icon":"car","href":"/mini-apps/airport-rides/integration"}]},{"group":"Changelog","pages":[{"title":"iOS SDK","icon":"","href":"/changelog/ios-sdk"},{"title":"Android","icon":"","href":"/changelog/android"},{"title":"Flutter","icon":"","href":"/changelog/flutter"},{"title":"React Native","icon":"","href":"/changelog/react-native-sdk"},{"title":"Expo","icon":"","href":"/changelog/expo"},{"title":"Capacitor JS","icon":"","href":"/changelog/capacitor"}]}]},{"tab":"Host Apps","pages":[{"title":"Host Apps","href":"/host-apps/introduction"}]},{"tab":"Miniapps","pages":[{"title":"Introduction","icon":"","mode":"wide","href":"/miniapp/Intro"},{"title":"Key Principles","icon":"","href":"/miniapp/KeyP"},{"title":"Getting Started","description":null,"icon":"","href":"/miniapp/GettingStarted"},{"title":"Design - UI/UX of Miniapps","icon":"","href":"/miniapp/Design"},{"title":"Miniapp Settings","description":null,"icon":"","href":"/miniapp/Settings"},{"title":"Miniapp Performance","icon":"","href":"/miniapp/Perf"},{"title":"Boxo Connect","href":"/miniapp/Connect"},{"title":"Boxo Payments","icon":"","href":"/miniapp/Payment"},{"title":"Error Codes","icon":"","href":"/miniapp/Error"},{"title":"Native Components","href":"/miniapp/Native"},{"title":"Miniapp Analytics","icon":"","href":"/miniapp/Analytics"},{"title":"Custom Events","icon":"","href":"/miniapp/CES"},{"title":"Standard Events","icon":"arrows-left-right","href":"/events/introduction"},{"title":"Refunds","icon":"rotate-left","href":"/events/refunds"},{"title":"Miniapp White-labeling","icon":"","href":"/miniapp/WhiteLabel"},{"title":"Testing","icon":"","href":"/miniapp/Testing"},{"title":"Security Measures","icon":"","href":"/miniapp/Security"},{"title":"Request Signaturing","icon":"","href":"/miniapp/Signaturing"}]},{"tab":"White Label Miniapps","pages":[{"title":"White Label Miniapps","href":"/mini-apps/esim/integration"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/MiniApp API Reference/EventsAPI"}]},{"tab":"UI Kit","href":"https://docs.boxo.io/ui-kit/"}]},"basePath":"","title":"Design - UI/UX of Miniapps - Boxo Documentation","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-BbK2OBGL.js","lightbox-handle-r17bVUz3.js"]}