> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useorbitcrm.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# App Guidelines

> Guidelines to ensure apps in the OrbitForms marketplace provide a great experience for users.

These guidelines ensure apps in the OrbitForms marketplace provide a great experience for users. Following these requirements will help your app pass review quickly.

## Core Requirements

> [card] Security
>
> Implement OAuth 2.0 correctly, validate all inputs, and handle user data securely.

> [card] User Experience
>
> Provide clear UI, helpful error messages, and intuitive workflows.

> [card] Performance
>
> Respond to webhooks within 5 seconds and maintain high availability.

> [card] Documentation
>
> Provide clear setup instructions and user documentation.

## Do's and Don'ts

### Do

> [!TIP]
>
> * Request minimal permissions
> * Provide clear error messages
> * Include a privacy policy
> * Handle rate limits gracefully
> * Offer a way to disconnect
> * Keep user data secure

### Don't

> [!WARNING]
>
> * Request unnecessary permissions
> * Store tokens insecurely
> * Ignore webhook failures
> * Mislead users about functionality
> * Collect data without consent
> * Violate rate limits repeatedly

## Branding Requirements

| Item | Requirement |
| - | - |
| App Icon | 512x512 PNG, no transparency required |
| App Name | Clear, descriptive, no trademarks you don't own |
| Description | Accurate summary of features (max 500 chars) |
| Screenshots | At least 2 screenshots showing key features |
| Category | Select the most appropriate category |

## Privacy & Data Handling

Your app must respect user privacy and comply with data protection regulations:

* Publish a clear privacy policy explaining what data you collect and how it's used
* Only collect data necessary for your app's functionality
* Provide users a way to request data deletion
* Don't share user data with third parties without explicit consent
* Implement appropriate security measures to protect user data

## Next Steps

> [card] [App Review](https://docs.useorbitcrm.ai/apps/app-review.md)
>
> Submit for marketplace listing.

> [card] [Best Practices](https://docs.useorbitcrm.ai/apps/best-practices.md)
>
> Tips for building great apps.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.