Your First Deployment
A complete walkthrough of deploying your first project
Overview
This guide walks you through deploying a project from start to finish, including selecting a repository, configuring build settings, and verifying your deployment.
Prerequisites
- A GitHub account connected to serverless.au
- A repository with a JavaScript/TypeScript project
- A framework we support (Next.js, React, Vue, Vite, etc.)
Create Your Project
1
Open New Project
From your dashboard, click New Project. You'll see a list of your GitHub repositories.
2
Select Repository
Search for or scroll to find your repository. Click on it to select it. We'll automatically detect your framework and suggest build settings.
3
Configure Settings
Review the detected settings:
- Project Name – Used for your subdomain
- Branch – The branch to deploy from
- Build Command – How to build your project
- Output Directory – Where built files are
4
Deploy
Click Create Project. Your first deployment starts immediately.
Watch Your Build
After creating your project, you'll see the deployment panel with live build logs. The deployment goes through these stages:
Pending– Deployment queued
Building– Installing dependencies and building
Success– Deployment live
Build logs stream in real-time. If something goes wrong, you'll see the error immediately.
Verify Your Deployment
Once the build succeeds, your app is live. Click the deployment URL to open it in a new tab.
text
Your deployment URL:
https://your-project.serverless.auDeployments are served from Australian edge locations, ensuring fast load times for your users.
Troubleshooting
Build Failed?
- Check the build logs for error messages
- Verify your build command works locally
- Ensure all dependencies are in package.json
- Check that environment variables are set if needed
Framework Not Detected?
If we couldn't detect your framework, you can manually configure the build command and output directory in project settings.