Documentation Questions and answers · Menu
QUESTIONS

Guardian questions and answers

23 direct answers. Where an answer needs more room, it links to the page that has it.

What Guardian is

What does Guardian do?

It reviews a mobile project on your machine for security risk, release-compliance gaps and missing release evidence, then turns that into a release decision you can explain to someone else.

See the checks catalogue
What works today?

A local Python analysis engine and a command-line interface. Project detection, scanning, the release check and reports in five formats are all part of the CLI. The macOS application is completing distribution verification and is not downloadable.

Release status
Which platforms are supported?

Flutter, native iOS and native Android. Which checks apply depends on your project structure and configuration, and Guardian reports the ones that did not run rather than skipping them silently.

Platform guides
How do I run my first scan?

Confirm the CLI responds, point it at a project directory, run detection, then run a release check and generate an HTML report. The whole sequence is four commands.

First scan walkthrough

Code and data

Does Guardian upload my source code?

No. A scan reads a directory that is already on your machine and writes its output there too. There is no upload step, and no account is involved.

Security and privacy
Can Guardian work offline?

Yes for local analysis — the scan command’s own help states that scans never use the network. Anything that depends on external data, such as advisory information, is only as current as the data on your machine.

Does it need access to my database?

No. Normal scanning needs no database connection at all, and Guardian should never ask you for production credentials or production data.

Does it require signing keys?

No. Signing certificates, provisioning profiles and signing keys stay in your environment and are outside any sharing contract, present or planned.

Can Guardian scan APK or IPA files?

The CLI ships a binary-analysis command group, so artefact analysis exists as a surface, but its per-check behaviour has not been verified for publication. Any artefact you analyse stays on your machine.

What that status means
How can I share a report safely?

Read it first. A report can contain file paths and project structure. Share the specific findings a reviewer needs rather than forwarding the whole file, and apply your own retention policy to what you keep.

Report handling

Analysis and results

What is the difference between source, binary and dynamic analysis?

Source analysis reads the project as written. Binary analysis inspects the artefact you are about to ship. Dynamic analysis observes the application while it runs. Guardian’s verified surface today is source and configuration analysis.

Is dynamic analysis production-ready?

No. The command group exists, but it has not been fully tested and its prerequisites are not documented. Treat any output as exploratory, and do not build a release gate on it.

What is and is not ready
What report formats are supported?

Text, JSON, SARIF, GitLab and HTML. Text for the terminal, HTML for people, JSON for your own tooling, SARIF and GitLab for code-scanning systems that already understand them.

Reports and formats
How do baselines work?

A baseline is a saved set of findings you have already accepted. Comparing against it separates what is new in this change from the backlog that already existed, so a team can adopt Guardian without fixing everything first.

Baselines and release gates
What does --fail-on-new do?

Used with a baseline, it makes the scan fail on findings that were not in the baseline, rather than on the existing backlog. It is the flag that makes a gate adoptable on an established codebase.

What does a release decision actually mean?

It reflects the analyzers that ran, the evidence available and the policy you configured — nothing more. Incomplete coverage is reported as incomplete and never counted as a pass.

How the decision is formed
How are false positives handled?

Each documented check lists the situations where it can be wrong, so you can judge a finding in context. A baseline is the supported way to carry accepted findings forward today.

Per-check considerations
Does Guardian replace a penetration test?

No. It also does not replace platform review, human security review, QA execution, or legal and regulatory advice. It makes the routine, repeatable checks cheap so that expert time goes to the parts that need it.

Running and integrating

Can Guardian run in CI/CD?

Yes — inside your own runner, as the same CLI your pipeline invokes. Nothing is sent to a Guardian service. Templates are provided for shell, GitHub Actions, GitLab CI, Bitrise and Jenkins.

CI/CD integration
Is the macOS application available?

Not yet. Its distribution build is completing signing, notarization and Gatekeeper verification, and we publish it once those pass rather than shipping something you have to click past a warning to open.

Release status
How is Guardian related to AI Growth Manager?

They are separate products, with separate repositories, deployments and databases. A future optional integration could pass approved, sanitized findings — never source, builds, secrets or raw reports.

Can I use Guardian without AI Growth Manager?

Yes. Guardian is independently useful, and nothing about it requires understanding or using another product.

Where can I see release status?

The release status page carries the current state of the CLI, the macOS distribution and the documentation, along with the known high-level limitations.

Release status