HELP CENTRE

How Configpair works, what it does, and how to reach us.

Everything you need to use Configpair effectively — getting started, answers to common questions, honest limits, and the one channel to contact a human.

01 / GETTING STARTED

Compare two env files in under thirty seconds.

  1. Navigate to the Compare page. You can also use the comparison widget on the home page — both work identically.
  2. Paste your first .env file into the left textarea. Any KEY=VALUE format works: DB_HOST=localhost, quoted values like APP_NAME="My App", commented lines starting with #, and blank lines are all handled.
  3. Paste your second .env file into the right textarea. The comparison runs automatically — there is no "Compare" button to press.
  4. Read the results grouped into three categories: MISSING (keys one file has that the other does not), CHANGED (same key, different value), and SAME (identical entries).
  5. Export or share using the toolbar: "Export CSV" downloads a structured file, "Copy report" puts a plain-text summary on your clipboard. Use "Show secrets" to reveal credential-shaped values that are masked by default.

02 / FAQ

The six questions people ask most often.

My env files contain API keys and database passwords. Are they safe?

Yes. Configpair runs entirely in your browser. The env content you paste never reaches any network — there is no upload, no API call, no server-side processing, and no storage. The comparison happens in-memory in your tab. Your data is as safe as the browser tab it is open in. If you close the tab, the data is gone.

Additionally, keys whose names suggest a credential (anything containing SECRET, TOKEN, PASSWORD, KEY, API and similar patterns) have their values masked by default in the output, so a screen share does not leak them. Click "Show secrets" to reveal them locally.

The results show a key as MISSING but I know it is in the file. What went wrong?

Configpair compares keys by exact string equality, case-sensitively. The most common causes of a false MISSING are:

  • Case difference: DB_HOST and db_host are treated as different keys.
  • Whitespace: A trailing space on one side (DB_HOST = value vs DB_HOST=value) — the tool strips spaces around the = sign, but a space inside the key name itself would make it different.
  • Quoting: DB_HOST="localhost" and DB_HOST='localhost' both parse to the key DB_HOST with value localhost (quotes are stripped). But if one side has DB_HOST="localhost" and the other has DB_HOST=localhost, the values are identical after parsing — this is handled correctly.
  • Multi-line values: Values that span multiple lines (using backslash continuation or quoted multi-line strings) are not supported. If your file uses these, the key may be parsed incorrectly. This is a known limitation (see below).

When in doubt, copy the two lines exactly as-is from your source files. The tool compares what it receives.

How do I see the actual values of masked secret keys?

Click the "Show secrets" button in the toolbar above the result area. This toggles all masked values to their full visible state. The button label changes to "Hide secrets" while they are visible. Click it again to re-mask them.

This toggle is local to your browser tab. Refreshing the page returns to the default masked state. There is no way to permanently unmask a value because nothing is persisted.

Can I save or bookmark a comparison to come back to later?

No. Configpair does not store comparison results or provide shareable URLs. Once you close the tab or refresh the page, the comparison is gone. This is by design: the tool has no server and no database — it cannot save anything even if it wanted to.

If you need a permanent record:

  • Export CSV — downloads a structured file you can open in any spreadsheet or text editor.
  • Copy report — puts a plain-text summary on your clipboard to paste into a ticket, document, or commit message.

Do this before navigating away from the page.

Can I compare more than two environment files at once?

Not in a single view. Configpair compares exactly two files — one on the left, one on the right. If your workflow involves three environments (for example, dev, staging, and production), run the tool twice: first compare dev vs staging, then staging vs production (or any pair you need).

A multi-file comparison view is not planned. The tool is deliberately narrow in scope: compare two files, show the difference, export the result.

Is Configpair free? Will it stay free?

Yes, Configpair is free. Every feature — paste, compare, toggle secret visibility, export CSV, copy report — is available immediately with no sign-up, no credit card, and no cap on how many files you compare.

There is no paid tier, no subscription, and no trial that expires. The tool runs in your browser and uses your CPU, not ours. It costs us nothing to serve, so charging for it would make no sense.

If a Team tier with server-side features (CI integration, automated drift detection, audit logs) is ever built, it would be a separate product on a different infrastructure model. The browser-based comparison tool this page describes would remain free.

03 / KNOWN LIMITATIONS

What Configpair does not do — stated plainly.

These are not bugs. They are deliberate architectural constraints of a browser-only, serverless tool. If any of these gaps prevent you from using Configpair, let us know — knowing what people actually need helps us decide what to build next.

File upload

There is no file-upload button. Paste the content directly. This is deliberate: a file picker offers no advantage over copy-and-paste and adds UI surface for something that works trivially.

No CI/API

Configpair has no API and no integration with CI pipelines (GitHub Actions, GitLab CI, etc.). A CI-integrated drift checker is a different product that would need infrastructure Configpair does not have.

No history

Every comparison is ephemeral. There is no history, no audit log, and no way to retrieve a session after the tab closes. Export before you leave.

No secret manager sync

Configpair does not connect to AWS Secrets Manager, HashiCorp Vault, or any external credential store. You provide both env files as text.

No value validation

The tool parses KEY=VALUE lines. It does not check whether a value is a reachable URL, a valid port number, a well-formed JSON string, or anything else about the content.

No multi-line values

Env files with values that span multiple lines (using backslash continuation or quoted multi-line strings) are not fully supported. Only single-line KEY=VALUE entries are parsed correctly.

04 / CONTACT

How to reach a human.

Configpair is a small tool. There is no phone number, no chat widget, and no social media account. If you need help, have a suggestion, or found something that does not work as expected, the one way to reach us is email.

Support email

What to include for the fastest response:

  • → A clear description of what you are trying to do
  • → What you expected to happen vs what actually happened
  • → If the issue is with a specific comparison, paste the keys involved (not the full file unless it contains no secrets)

Response time: This product is maintained by a small team. You will receive a reply, but it may not be immediate. For time-sensitive issues, include [URGENT] in the subject line.

Note: agen2ic.ai accepts mail at any local part. The configpair@ prefix tells the routing system which product your message is about, so you get the right person on the first reply.