# Project patterns

The rest of the user guide explains what Flyte can do.
This section explains how we recommend you structure real projects.

These are opinionated guides. They represent patterns we've seen work well across many teams and production deployments. If you're starting a new project or scaling an existing one, start here.

### [Bring your own image (BYOI)](https://www.union.ai/docs/v2/union/user-guide/project-patterns/bring-your-own-image/page.md)

Two patterns for teams that own their Docker images and want Flyte for orchestration without handing over their build pipeline.

### [Monorepo with uv](https://www.union.ai/docs/v2/union/user-guide/project-patterns/monorepo-with-uv/page.md)

How to structure Flyte projects with uv, from single-package setups to multi-team monorepos with shared and independent lockfiles.

## Subpages

- [Bring your own image (BYOI)](https://www.union.ai/docs/v2/union/user-guide/project-patterns/bring-your-own-image/page.md)
  - The multi-team problem
  - Pattern 1: Pure BYOI
  - Dockerfiles
  - Build and push
  - Python code
  - Run and deploy
  - Pattern 2: Remote Builder
  - The base images
  - Adapting with `flyte.Image`
  - Task definitions
  - Entry point
  - Run and deploy
  - Decision matrix
- [Monorepo with uv](https://www.union.ai/docs/v2/union/user-guide/project-patterns/monorepo-with-uv/page.md)
  - The two layers
  - How the image gets built
  - `with_code_bundle()` — one image for dev and prod
  - `root_dir`
  - Monorepo patterns
  - Pattern A: Shared lockfile (recommended)
  - Pattern B: Independent packages
  - The full build path (production)

---
**Source**: https://github.com/unionai/unionai-docs/blob/main/content/user-guide/project-patterns/_index.md
**HTML**: https://www.union.ai/docs/v2/union/user-guide/project-patterns/
