Create a Mini App

This guide walks you through creating a mini app in the Alien Developer Portal.

Prerequisites

An Alien account
A web application ready to be hosted (or a planned URL)

Step 1: Access the Developer Portal

Navigate to https://dev.alien.org/
Sign in with your Alien account
Select Mini Apps from the dashboard

Step 2: Create a New Mini App

Click Create Mini App to open the configuration form.

Required Fields

Field	Description
Name	Display name shown to users
Description	Short summary of what your app does
Logo	Icon displayed in the Alien app (512x512px)
URL	Public URL where your mini app is hosted
Allowed Origins	Domains authorized for the bridge

Example Configuration


Name: My Game
Description: A fun puzzle game built for Alien
URL: https://mygame.example.com
Allowed Origins: https://mygame.example.com

Step 3: Understanding Your Slug

When you create a mini app, a unique slug is automatically generated from your app’s name. This slug identifies your mini app in the Alien ecosystem.

Users can launch your app via deeplink: https://alien.app/miniapp/{slug}

Step 4: Test Your Mini App

Once created, you can test your mini app:

Browser Testing: Run your app in a regular browser to test UI and logic. The Bridge SDK will log warnings but won’t block development.
In-App Testing: Copy the deeplink from your mini app dashboard in the Developer Portal and open it on your device. This launches your mini app in the Alien app’s WebView environment.

Next Steps

Install Boilerplate — Pre-configured template
Testing — Test locally and in the Alien app
React SDK — React hooks and components
Authentication — Implement user authentication
Payments — Accept payments