Create a New Project¶

This guide covers how to bootstrap a new application project under Subscribed.

1. Create the GitHub repo¶

Create a private repo under the subscribed-aps organisation.
Naming convention: kebab-case, no suffixes like -app.

2. Add internal packages¶

Add our private repo registry to composer.json:

{
    "repositories": [
        {
            "type": "vcs",
            "url": "git@github.com:subscribed-aps/wp-pkg-otp.git"
        }
    ]
}

Require relevant internal packages:

composer require subscribed-aps/wp-pkg-otp:^1.0

3. CI/CD¶

All projects must have a GitHub Actions workflow that runs tests and static analysis on PRs. See the Composer package guide for a workflow template.

4. Branching¶

Follow our Git Branching strategy.

5. First deploy¶

See the PR Checklist before your first merge to main.