Skip to main content

​
Apps in UptopiaKit

An App in UptopiaKit represents your product — a game, web app, or miniapp — managed end-to-end in a single dashboard. Use Apps to organize your portfolio, configure platform manifests, upload versions, preview safely, collaborate with teammates, and publish across supported miniapp platforms.

​
Why it matters

  • One place to manage all product details across platforms
  • Clear versioning and environments to move safely from Development → Testing → Production
  • Built-in collaboration, submissions, and monetization paths

​
Limits (Free tier)

  • You can create up to 20 owned Apps on the Free tier.
  • You can be added as a team member on up to 100 Apps on the Free tier.
If you need higher limits, contact us to discuss an upgrade.

​
Basic Settings

The Basic Settings page is where you configure core details of your App. Only the App Owner can view and edit Basic Settings. What you can manage:
  • App icon: upload or update your App icon.
  • App name: set or rename the App.
  • App status: Active or Inactive.
    • Active: the App operates normally. Other team members can access the App and use features.
    • Inactive: the App is disabled. Only the App Owner can view its details. All related functionality is disabled — versions cannot run, and the App cannot be submitted for public availability.
  • Orientation: Portrait or Landscape.
    • Most platforms display Apps in Portrait only. If you set Landscape, UptopiaKit will try to render your App in Landscape, but some platform features or integrations may not function as expected.
  • Identifiers (read-only with copy):
    • App ID: a unique identifier for your App.
    • App Key: a secret key for App-level authentication.

​
About the App Key

The App Key authenticates your App when calling UptopiaKit APIs or invoking platform features exposed by UptopiaKit. Treat it like a secret:
  • Do not share it publicly or embed it in client-side code without protection.
  • Rotate it if you suspect exposure.
  • Use it only in secure contexts according to your integration needs.

​
Manifests and platform details

Each platform (for example, Farcaster or The Base App) may require specific manifest fields (name, icons, categories, permissions, etc.). UptopiaKit surfaces these requirements in the dashboard so you can fill them in and pass reviews smoothly. See also: platform-specific guides (coming soon).

​
Versions and environments

Apps use Versioning to move safely from Development → Testing → Production:
  • Development: iterate quickly; internal access only.
  • Testing: share for review and verification.
  • Production: public, stable releases.
You upload new versions in the dashboard and set their environment. Only Active Apps can run versions and progress through environments.

​
Preview and display

  • Open and preview the App directly inside UptopiaKit, including selecting specific versions.
  • Preview on Farcaster using a managed developer miniapp provided by UptopiaKit.
  • Orientation rules apply (Portrait recommended; Landscape may have limited support depending on the platform).

​
App Events (overview)

App Events are the bridge between your App and UptopiaKit via postMessage. Use them to:
  • Request capabilities provided by UptopiaKit (for example, platform actions).
  • Receive and respond to platform or host events.
  • Build richer, native-feeling flows while keeping your App portable across platforms.
A dedicated UI in the dashboard helps you define, test, and monitor App Events.

​
Owners and team members

  • App Owner: full control over the App, including Basic Settings and sensitive actions.
  • Team Members: collaborate based on assigned permissions. Owners can share access and configure roles.
  • Revenue sharing: align incentives among collaborators (details vary by plan and setup).

​
Submissions (go public)

By default, newly created Apps are restricted to the Owner and Team Members, including access to assets. When you’re ready for users to discover and use your App across supported platforms, create a Submission. Our team will review and enable public availability. Notes:
  • Inactive Apps cannot be submitted.
  • Ensure required manifest fields and policies are satisfied before submitting.

​
Monetization (roadmap)

  • In‑App Purchases (IAP): define packages and track revenue — in development.
  • Advertisements: access Uptopia’s ad network to place ads and monetize — in development.
We’ll publish detailed setup guides as these features roll out.

​
Delete App

Use Delete App to permanently remove an App from UptopiaKit.
  • This action is irreversible and will remove the App and its related data from the platform.
  • Once deleted, the App is no longer accessible, its versions cannot be run, and it cannot be distributed or submitted.
Proceed with caution and ensure you’ve exported any data you need before deleting.
  • Versioning and environments (detailed guide)
  • App Events (detailed guide)
  • Teams and permissions (detailed guide)
  • Submissions (detailed guide)
  • Platform manifests (Farcaster, The Base App)