Skip to main content

​
Prerequisites

  • A GitHub account
  • A repository (public or private)

​
Step 1 — Create apply.yaml

Create a file named apply.yaml in the root of your repository: 
version: 1
title: Join the team
sections:
  - id: main
    title: Apply to work with us
    fields:
      - id: full_name
        type: short_text
        label: Full name
      - id: role
        type: single_select
        label: Role you're applying for
        options:
          - Software Engineer
          - Product Manager
          - Designer
      - id: email
        type: email
        label: Email address
    next: done
This is a complete form — three different field types (short_text, single_select, email), no extra configuration needed.

​
Step 2 — Push to main

git add apply.yaml
git commit -m "Add job application form"
git push

​
Step 3 — Visit your form

https://app.declarativeforms.com/{owner}/{repo}/apply
Replace {owner} with your GitHub username or organization, and {repo} with your repository name. The form is live immediately — no deploy step required.
Your form is live. Change a field label, push again, the form updates instantly. The next page explains what just happened. How it works →