> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitforms.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

<CardGroup cols={1}>
  <Card title="Security" icon="shield">
    Implement OAuth 2.0 correctly, validate all inputs, and handle user data securely.
  </Card>

  <Card title="User Experience" icon="users">
    Provide clear UI, helpful error messages, and intuitive workflows.
  </Card>

  <Card title="Performance" icon="zap">
    Respond to webhooks within 5 seconds and maintain high availability.
  </Card>

  <Card title="Documentation" icon="book">
    Provide clear setup instructions and user documentation.
  </Card>
</CardGroup>

## 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
</Tip>

### Don't

<Warning>
  * Request unnecessary permissions
  * Store tokens insecurely
  * Ignore webhook failures
  * Mislead users about functionality
  * Collect data without consent
  * Violate rate limits repeatedly
</Warning>

## 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

<CardGroup cols={2}>
  <Card title="App Review" icon="check-circle" href="/apps/app-review">
    Submit for marketplace listing.
  </Card>

  <Card title="Best Practices" icon="book" href="/apps/best-practices">
    Tips for building great apps.
  </Card>
</CardGroup>