Start from a template
Quant provides ready-to-deploy templates for popular frameworks. The template wizard creates a GitHub repository, configures your Quant project, sets up secrets, generates a deployment workflow, and triggers the first build — all in one step.
Available templates
Section titled “Available templates”Static site templates
Section titled “Static site templates”| Template | Framework | Description |
|---|---|---|
| Next.js | Next.js (Static Export) | React framework with static generation |
| Nuxt | Nuxt (Static) | Vue.js framework with static generation |
| Gatsby | Gatsby | React-based static site generator |
| Hugo | Hugo | Fast Go-based static site generator |
| Astro | Astro | Content-focused web framework |
| Eleventy | Eleventy | Simpler static site generator |
| VitePress | VitePress | Vite-powered static documentation |
| Docusaurus | Docusaurus | Documentation-focused site generator |
| MkDocs | MkDocs | Python documentation generator |
| Vite | Vite | Modern frontend build tool |
| Jekyll | Jekyll | Ruby-based static site generator |
Cloud application templates
Section titled “Cloud application templates”| Template | Stack | Description |
|---|---|---|
| Node.js | Node.js + Express | Server-rendered Node.js application |
| Laravel | PHP + Laravel | Full-featured PHP framework |
| Django | Python + Django | Python web framework |
| WordPress | PHP + WordPress | Content management system with database |
Create a static site from a template
Section titled “Create a static site from a template”- In the Quant dashboard, go to Projects → New Project
- Select Start from a template
- Choose a template — browse the available static site templates and select one
- Connect GitHub — if you haven’t connected yet, you’ll be prompted to install the GitHub App. If you have multiple installations, select the one to use.
- Configure your project:
- Repository name — name for the new GitHub repository (auto-generated from template name, e.g.,
my-astro-site) - Project name — name for your Quant project
- Visibility — public or private repository
- Repository name — name for the new GitHub repository (auto-generated from template name, e.g.,
- Click Create and watch the progress
The wizard shows real-time status as it works through each step. When complete, you’ll see links to your new GitHub repository, the Quant project, and your live site URL.
Create a cloud application from a template
Section titled “Create a cloud application from a template”- In the Quant dashboard, go to Cloud Apps → New → Starter Kit
- Choose a template — select from the available cloud application templates
- Connect GitHub — connect or select a GitHub installation
- Configure your application:
- Repository name — name for the new GitHub repository
- Application name — name for your Quant Cloud application
- Visibility — public or private repository
- Click Create and monitor the progress
What happens behind the scenes
Section titled “What happens behind the scenes”When you create a project from a template, the wizard performs these steps automatically:
| Step | What happens |
|---|---|
| 1. Create repository | A new GitHub repository is created in your account from the selected template |
| 2. Create project/app | A Quant project (static) or Cloud application is created in your organisation |
| 3. Generate token | A deployment token is created with the necessary permissions |
| 4. Set secrets | Deployment credentials are encrypted and stored as GitHub repository secrets |
| 5. Add workflow | A GitHub Actions workflow is committed to .github/workflows/deploy.yml |
| 6. Trigger deployment | The first deployment is triggered automatically |
For static sites, the secrets stored are:
| Secret/Variable | Purpose |
|---|---|
QUANT_TOKEN | Deployment token (secret) |
QUANT_CUSTOMER | Organisation ID (variable) |
QUANT_PROJECT | Project name (variable) |
For cloud applications, the secrets stored are:
| Secret/Variable | Purpose |
|---|---|
QUANT_API_KEY | API deployment token (secret) |
QUANT_ORGANIZATION | Organisation name (variable) |
QUANT_APPLICATION | Application name (variable) |
QUANT_BASE_URL | API endpoint (variable) |
Customising after creation
Section titled “Customising after creation”Once the wizard completes, the new repository is a standard GitHub repo that you own. To make changes:
-
Clone the repository:
Terminal window git clone https://github.com/your-username/your-repo-name.gitcd your-repo-name -
Make your changes — edit content, add pages, update styles
-
Push to redeploy:
Terminal window git add .git commit -m "Update site content"git push
Every push to the default branch triggers a new deployment automatically via the GitHub Actions workflow.
Next steps
Section titled “Next steps”- Add a custom domain — Point your own domain to your new site
- Import a repository — Already have a repo? Import it instead
- Framework guides — Framework-specific configuration tips