ActiveManage Docs ← Back to activemanage.co.uk

Editing Custom Code

Editing custom code via the in-browser IDE feels lightweight but the code runs in production. A small set of disciplined practices keeps quick edits safe.

IDE showing a custom function being edited: side-by-side diff view comparing current saved version with the new draft, test panel underneath with input JSON and expected output, Save / Test / Deploy buttons

The Loop

  1. Read: Open the snippet; understand what it does now. Don't skip this even for “quick” fixes.
  2. Branch in your head: Imagine what the new code should do; check it against the existing behaviour.
  3. Edit: Make the smallest change that achieves the goal.
  4. Test in dev: Use the test runner with sample input.
  5. Save: Creates a new version. Doesn't yet deploy.
  6. Deploy: Activates the new version. Production starts using it.
  7. Watch: Monitor error logs and performance for the next 15 minutes.

Things to Avoid

  • Editing without reading: Surprises lurking in the snippet you didn't read.
  • Deploying without testing: Even trivial-looking changes can break in subtle ways.
  • Big refactors in the browser: The in-browser IDE is for small changes. Big refactors deserve a real editor and a real PR review.
  • Skipping the audit trail: The platform records every change; don't shortcut by editing the underlying database.

When to Use a Real IDE Instead

  • Changes that span 5+ files.
  • Anything that needs unit tests.
  • Code that warrants code review before going to prod.
  • Refactors and renames.
  • New features (use git, PRs, deployments).

Worked Examples

  • Typo fix: In-browser is perfect — 30 seconds.
  • Add a missing validation: In-browser fine — test in dev, deploy.
  • Rename a function across 12 places: Real IDE, git branch, PR review.
  • New API endpoint: Real IDE plus integration tests.