Repository preparation

Prepare your own GitHub repository for Forge by committing its source and mithran.yaml. Forge requests repository authorization when deployment needs access, without a separate registration step.

Existing repository

Keep your GitHub origin and application source. Follow Configure your app to initialize Forge configuration or validate an existing manifest without rewriting it.

Review and commit the intended changes, then push the commit to GitHub. Forge deploys committed HEAD by default, so it needs that commit to be available from the origin.

New repository

Follow Quickstart to generate a static starter and connect it to an empty GitHub repository. Edit the starter, then commit and publish the application you want to deploy.

Before deployment

Test your app locally and review its manifest. Keep credentials out of the source and configuration you commit.

Use your GitHub credentials for ordinary Git operations. Aegis account sign-in and Forge GitHub App repository authorization are separate steps; see Account setup for their roles.