Creating Your First Application

This guide walks you through the complete process of setting up and deploying an application on the App Platform, from initial creation to local development and production deployment.

Step 1: Create Your Application

1. Navigate to the Applications Tab in the App Platform
2. Click on Create New Application
3. Enter your application's name
4. Select a template to start from (this provides a basic project structure with the specified frameworks)
5. Click Create - the platform will automatically create your application with a git repository

Step 2: Configure Permissions

Before you start developing, set up who can access and work on your application.

Add Developers

1. Go to the Permissions tab
2. Under Developers, add users who should be able to:
   • Modify application configuration
   • Manage builds
   • Access the workspace
   • Have full control over the application

Define Application Users

1. In the same Permissions tab, under Users
2. Add organizations and users who are authorized to access and use your deployed application
3. Only listed users and members of listed organizations will be able to interact with the application

Step 3: Develop your Application

You have multiple options to develop your application.

Option A: Use Browser-Based IDE

1. Go to the Workspace tab
2. Choose between:
   • CODIUM IDE: Browser-based VS Code environment with full workspace access
   • OPENCODE IDE: Alternative browser-based IDE option
3. Click the IDE URL to open your application's workspace directly in the browser

Option B: Use Local Development Environment

See Local Development

Step 4: Build Your Application

Once you've made changes to your code, you need to build the application.

Create a New Build

1. Commit and push your changes to the main branch of your git repository
2. Navigate to the Build tab inside your application settings on the App Platforms
3. Click Build Latest to trigger a new build from the most recent commit
4. Wait for the build to complete

Verify the Build

1. Check that your commit message appears as the latest build
2. If your commit doesn't appear, there was likely a build error
3. Check the Operation Log for detailed error information

Step 5: Deploy and Start Your Application

Now that your application is built, let's get it running.

1. Go back to the Application Details tab
2. If your application is currently running, click Stop first
3. Click Start to launch your application with the newest build
4. The Started Version field should change to the newest build version.
5. Monitor the Application Log for real-time output from your running application
6. Note the small link icon next to the Status which links to the deployed version of your application.

Your application is now live and accessible to authorized users.