# Rendering Pipeline
`nyl render`, `nyl diff`, and `nyl apply` share the same manifest generation pipeline.
## Shared Pipeline Steps
1. Load project configuration and select the active profile.
2. Load secrets and build the template context.
3. Load the input manifest file and render Jinja templates.
4. Apply `--only-source-kind` filtering on top-level input resources (before expansion).
5. Expand resources recursively (`HelmChart`, `Component`, `RemoteManifest`, aliases) with `--max-depth`.
6. Process `ApplicationGenerator` resources into Argo CD `Application` manifests.
7. Apply Kyverno policies (Global scope currently supported).
8. Deduplicate final manifests (last occurrence wins).
9. Apply post-render kind filtering with `--only-kind` / `--exclude-kind`.
## Namespace Resolution (Online Mode)
In online mode, Nyl connects to Kubernetes and resolves missing `metadata.namespace` for namespaced resources.
Fallback order:
1. Existing `metadata.namespace`
2. Release namespace hint (`NylRelease.metadata.namespace` or `--namespace` for release commands)
3. Kube context default namespace
4. Error if no namespace can be determined
When `--offline` is used (`render` only), namespace resolution is skipped.
## Online vs Offline
- `render --offline`:
- does not connect to the cluster for API discovery during rendering;
- requires `--kube-version` and `--kube-api-versions`;
- skips namespace resolution.
- `render` (without `--offline`), `diff`, and `apply`:
- require cluster connectivity;
- initialize Kubernetes discovery once per command run and reuse it for scope checks.
## Command-Specific Behavior After Rendering
- `render`: outputs rendered YAML to stdout.
- `diff`: compares desired state with live cluster state and prints differences.
- `apply`: applies resources and manages release tracking/pruning.
## Source Filter vs Post-Render Filters
- `--only-source-kind` filters only top-level resources in the input file, before expansion.
- `--only-kind` / `--exclude-kind` filter the final rendered manifests, after expansion.