# Preflight > Preflight is a set of GitLab CI/CD components for Wayne State apps. Include them and your pipeline runs PROCTOR, PHP tests on each supported version, a Composer audit, an SBOM, Pint, PHPStan and ESLint. **Every push is cleared for takeoff.** Preflight is a set of GitLab CI/CD components that give every WSU app the same checks: PROCTOR, PHP tests on each supported version, Composer and npm audits, an SBOM, Pint, PHPStan, ESLint, secret detection, an accessibility gate, migrations on MySQL 5.6 and a portability probe that boots the image the way OpenShift, Coolify and plain Docker do. **Not to be confused with:** Preflight is the CI pipeline; it runs Pinstripe's style checks and PROCTOR but sets neither. Front page: [`site/index.html`](https://github.com/waynestate/preflight/blob/HEAD/site/index.html), a static page; see [`site/README.md`](https://github.com/waynestate/preflight/blob/HEAD/site/README.md). On Citadel it is served by the raw-PHP deploy layer in [`deploy/`](https://github.com/waynestate/preflight/blob/HEAD/deploy/): a Squire kit whose front controller serves `site/` behind HELMET's security headers. For local development, keep serving `site/` directly. Documentation: the full manual lives at [preflight.apps.wayne.edu/docs/](https://preflight.apps.wayne.edu/docs/). Every page below is Markdown. The HTML pages send the same Markdown to a client that asks for `text/markdown`. Written by Squire's agent-ready kit from the README and the pages; do not edit. ## Pages - [Preflight: Every push is cleared for takeoff.](https://preflight.apps.wayne.edu/index.md): Preflight is a set of GitLab CI/CD components for Wayne State apps. Include them and your pipeline runs PROCTOR, PHP tests on each supported version, a Composer audit, an SBOM, Pint, PHPStan and ESLint. - [Changelog | Preflight docs](https://preflight.apps.wayne.edu/docs/changelog.md): All notable changes to this project. - [The a11y component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-a11y.md): Opens the app's pages in a real browser and fails the pipeline on accessibility violations (axe-core in Playwright). - [The composer-audit component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-composer-audit.md): Runs `composer audit --locked` and fails on advisories. - [The composer-ci component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-composer-ci.md): Runs `composer install` and then `composer ci`, and fails the job when either fails. - [The eslint component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-eslint.md): Runs the app's own ESLint and Prettier and fails the pipeline on lint or format errors. - [The mysql56-migrate component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-mysql56-migrate.md): Runs the app's migrations against MySQL 5.6.51, the version of the shared server on Citadel. - [The npm-audit component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-npm-audit.md): Runs `npm audit` on the app's lock file and fails on advisories at or above a severity. - [The package-publish component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-package-publish.md): Publishes a semantic version tag to the GitLab group's built-in Composer registry. - [The php-test component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-php-test.md): Runs the test command on each supported PHP version through `parallel:matrix`. - [The phpstan component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-phpstan.md): Runs the app's own PHPStan and fails the pipeline on static analysis errors, writing a GitLab Code Quality report. - [The pint component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-pint.md): Runs the app's own Laravel Pint in test mode and fails the pipeline on style errors. - [The portability component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-portability.md): Proves the app image runs the way OpenShift, Coolify and plain Docker run it, not only on Citadel. - [The proctor component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-proctor.md): Runs `vendor/bin/proctor check --format=codequality` and publishes the result as a GitLab Code Quality report. - [The renovate component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-renovate.md): Runs Renovate as a scheduled or manual job that bumps versions across the group's repositories and merges the green ones itself. - [The sbom component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-sbom.md): Generates a CycloneDX SBOM, validates it, and publishes it as an artifact. - [The secret-detection component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-secret-detection.md): Scans the checked-out tree for committed secrets with Gitleaks and fails the pipeline when one is found. - [The squire-kit component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/component-squire-kit.md): Fails the pipeline when a Squire deploy kit drifts from the Squire release recorded in its .squire.json. - [Dependency caching | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/dependency-caching.md): Docker Hub images come through GitLab's Dependency Proxy and Composer and npm downloads are cached, so busy pipelines do not get the runner rate limited. - [Deprecating and removing a component | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/deprecation.md): How a Preflight component is announced as deprecated, how long its old tag keeps working, and when it may be removed. - [GitHub mirrors | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/github-mirrors.md): A reusable GitHub Actions workflow runs the same checks for packages mirrored to `github.com/waynestate`. - [Updating image pins | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/image-pins.md): Every image the components run is pinned by digest, so a repointed tag cannot quietly change what a pipeline executes. - [Include a component twice | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/include-twice.md): Set the `job_name` input when one project includes the same component more than once. - [The inputs contract | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/inputs-contract.md): What a Preflight pin promises your includes, where that promise is written down, and how to see what moved between two tags. - [Strongly recommended: a git.wayne.edu instance runner | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/instance-runner.md): Ask for a non-privileged Docker executor, a fresh ephemeral environment for every job, and no shell executor shared between projects. - [Keep the job token allowlist short | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/job-token-allowlist.md): List only the projects an app really needs in its CI/CD job token allowlist, and review the list when a dependency is dropped. - [Which hosts the jobs reach | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/network-egress.md): Every host a Preflight job or its image pull reaches, by component, for a runner whose network is locked down. - [Quick start | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/quick-start.md): Wire one Preflight component into an app and watch the pipeline run it. - [Renovate | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/renovate.md): Preflight owns the stack's version automation: the shared preset and the component that runs it. - [Same instance only | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/same-instance-only.md): Components work only inside the GitLab instance that hosts this project. - [Template lint | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/template-lint.md): `composer ci` scans the templates for unsafe CI patterns before the fixture tests. - [What the components cannot force | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/what-components-cannot-force.md): An included component is a set of ordinary jobs that the app's own `.gitlab-ci.yml` is merged over. - [When the components run | Preflight docs](https://preflight.apps.wayne.edu/docs/guides/when-components-run.md): The components are ordinary jobs, so they run whenever the app's pipeline runs. - [Preflight | Preflight docs](https://preflight.apps.wayne.edu/docs/index.md): Preflight is a set of GitLab CI/CD components that give every WSU app the same checks. - [Install | Preflight docs](https://preflight.apps.wayne.edu/docs/install.md): Add Preflight's components to an app's .gitlab-ci.yml with one include per component. - [Components | Preflight docs](https://preflight.apps.wayne.edu/docs/reference/components.md): Every component, with its include example, inputs and defaults. - [Shared conventions | Preflight docs](https://preflight.apps.wayne.edu/docs/reference/conventions.md): The conventions the stack shares: Composer vendor, license, PHP floor and JavaScript installs. - [Local checks | Preflight docs](https://preflight.apps.wayne.edu/docs/reference/local-checks.md): How maintainers build, test and release this project with Docker. - [Proof | Preflight docs](https://preflight.apps.wayne.edu/docs/reference/proof.md): Preflight's components run against 82 Wayne State applications on 2026-11-05: what ran, what held, what it caught in Preflight itself, what it does not prove, and how to run the same on your app. - [Troubleshooting | Preflight docs](https://preflight.apps.wayne.edu/docs/troubleshooting.md): What to do when a Preflight job fails or a gate behaves unexpectedly. - [Upgrading | Preflight docs](https://preflight.apps.wayne.edu/docs/upgrading.md): How to move an app from one Preflight pin to the next. ## Prompts - [Get started with Preflight](https://preflight.apps.wayne.edu/#prompt-get-started): The agent writes your app's .gitlab-ci.yml with the components that fit it, whether it's raw PHP, Laravel with Blade, or Laravel with Inertia and Vue. The prompt itself is in https://preflight.apps.wayne.edu/index.md. - [Preflight on a package's GitHub mirror](https://preflight.apps.wayne.edu/#prompt-github-mirror): Components can't leave their GitLab instance, so a waynestate/ package mirrored to GitHub calls Preflight's reusable workflow instead. The prompt itself is in https://preflight.apps.wayne.edu/index.md. - [Version upkeep with Preflight's Renovate preset](https://preflight.apps.wayne.edu/#prompt-renovate): One renovate.json that extends the shared preset. Patch and minor updates merge themselves when the pipeline is green; majors wait for a person. The prompt itself is in https://preflight.apps.wayne.edu/index.md. ## Source - [README](https://github.com/waynestate/preflight/blob/HEAD/README.md): the project's README, with install, commands and checks - [Everything in one file](https://preflight.apps.wayne.edu/llms-full.txt): the README and every page above, as one Markdown file ## Optional - [ADVISOR](https://advisor.apps.wayne.edu/llms.txt): the stack's MCP server: read-only tools that answer from CREED's policy and the parts' docs instead of from memory - [WELD](https://weld.apps.wayne.edu/llms.txt): the Wayne State application stack: every part, and the reference app