Write a Pipeline Config (.oore.yaml)

The .oore.yaml file defines how Oore CI builds your Flutter application. Place it in the root of your repository — Oore CI reads it at build time.

What you need

• A project in Oore CI
• A Flutter repository

Minimal example

version: 1
flutter_version: "3.24.0"
platforms:
  - android
commands:
  pre_build:
    - flutter pub get
  build:
    - flutter build apk --release
  post_build: []
artifacts:
  patterns:
    - "**/*.apk"

Full schema

For the complete .oore.yaml schema reference, see .oore.yaml Reference.

Top-level fields

Field	Type	Required	Description
version	integer	Yes	Schema version (must be 1)
flutter_version	string	No	Flutter version to use. Overridden by .fvmrc if present.
platforms	string[]	Yes	Target platforms: android, ios, macos
commands	object	Yes	Build command stages
artifacts	object	No	Artifact collection patterns

Commands

Commands are executed in three stages:

Stage	When it runs	Typical use
pre_build	Before the main build	flutter pub get, code generation
build	Main build step	flutter build apk, flutter build ipa
post_build	After a successful build	Testing, additional processing

Each stage is a list of shell commands executed sequentially. If any command returns a non-zero exit code, the build fails.

Platform-specific build args

platform_build_args:
  android:
    extra_args: "--split-per-abi"
  ios:
    export_method: "ad-hoc"

Platform-specific commands

Override the default build command per platform:

platform_commands:
  android:
    build:
      - flutter build apk --release --split-per-abi
  ios:
    build:
      - flutter build ipa --release --export-method ad-hoc

Environment variables

env:
  - key: JAVA_HOME
    value: /usr/local/opt/openjdk@17
  - key: MY_BUILD_VAR
    value: custom-value

Artifact patterns

artifacts:
  patterns:
    - "**/*.apk"
    - "**/*.ipa"
    - "**/*.app.zip"

Glob patterns are matched against the build output directory.

Trigger configuration

triggers:
  events:
    - push
    - pull_request
  branches:
    - main
    - "release/*"

Concurrency

concurrency:
  max_concurrent: 1
  cancel_in_progress: true

Multi-platform example

version: 1
flutter_version: "3.24.0"
platforms:
  - android
  - ios
commands:
  pre_build:
    - flutter pub get
    - dart run build_runner build --delete-conflicting-outputs
  build:
    - flutter build apk --release
    - flutter build ipa --release --export-method ad-hoc
  post_build: []
platform_build_args:
  android:
    extra_args: "--split-per-abi"
artifacts:
  patterns:
    - "**/*.apk"
    - "**/*.ipa"
triggers:
  events:
    - push
  branches:
    - main

Config resolution

Oore CI resolves pipeline configuration in this order:

1. .oore.yaml (or .oore.yml) in the repository root — highest priority
2. Pipeline execution config set via the UI — fallback

If both exist, the file takes precedence.

For Flutter version resolution:

1. .fvmrc in the repository — highest priority
2. flutter_version in .oore.yaml — fallback
3. Pipeline's Flutter version setting in the UI — final fallback

Validation

Validate a pipeline config before creating a build:

curl -X POST http://127.0.0.1:8787/v1/pipelines/validate \
  -H "Authorization: Bearer <session_token>" \
  -H "Content-Type: application/json" \
  -d '{"config": "<yaml content>"}'