Deploy your first project

What you will build

You will create a small HTTP endpoint, connect its repository to Apex, and promote the resulting deployment to production. The same workflow also creates a preview environment so you can inspect changes before release.

1. Create the project

Create a project in the Apex console and choose a runtime. The project name becomes part of the default deployment URL. Keep the project small for the first run; routing and environment configuration can be added after the first successful build.

2. Connect the repository

apex auth login
apex project link
apex env pull --environment development

The CLI links your local directory to the project and keeps environment configuration explicit. Secrets are never written into source control.

3. Deploy

apex deploy --prod

Apex builds the project, runs deployment checks, publishes the immutable artifact, provisions the route, and returns the deployment URL. Open the URL and confirm both the application response and the deployment ID shown in the console.

4. Verify

• Check the deployment logs for build warnings and runtime errors.
• Open the request view and confirm the expected region is receiving traffic.
• Create a second deployment from a branch to verify the preview workflow before changing production.