FAQ and troubleshooting
Is AppArch a linter?
Section titled “Is AppArch a linter?”No. Linters look at a single file; AppArch looks at the whole project - layers, modules, contracts. It won’t say “this class is long”; it says “the UI is bypassing you and going straight to the DB.”
I’m getting false positives, what should I do?
Section titled “I’m getting false positives, what should I do?”Every rule has an except mechanism (an exemption in the definition) and an ignore mechanism (silencing a single finding). From a PR comment you can click “Accept” in one tap; ArchPilot remembers the context. You can also disable the rule per project/workspace in the panel. See Writing architecture rules.
My token is invalid / I’m getting a 401
Section titled “My token is invalid / I’m getting a 401”- Make sure the
APPARCH_TOKENsecret variable is defined in CI. - The token may have been revoked - generate a new one from the Credential Manager.
- A runner token is scoped to a single project + module; make sure you’re using the token for the correct project.
Comments are coming in the wrong language
Section titled “Comments are coming in the wrong language”The comment language is set per workspace: Settings → ArchPilot → Comment language. The technical part of the analyzer message stays in English.
I’m getting a limit-reached warning
Section titled “I’m getting a limit-reached warning”The project/member limit comes from your licence. If you need a higher one, talk to the AppArch team and a new licence file is issued (see Licence and limits).
Is our code safe?
Section titled “Is our code safe?”Yes - your source code never leaves your infrastructure; analysis runs in your own CI. Details: Security and privacy.
CI runs but no comment appears
Section titled “CI runs but no comment appears”- Make sure the pipeline is triggered only on PR/MR events.
- Verify that the module (ArchPilot) is enabled in the workspace.
- The bot account / integration user must have permission to write comments on the repo.