Skip to content

Docs: add local app debugging guide #275

Description

@sridharkalaibala

Parent: #34

Problem

Contributors need practical debugging steps for a local connector/app without touching production data.

Boundary

Documentation only. Do not add new tooling in this ticket.

Acceptance criteria

  • Document how to run a sample app/connector locally against a dev Posnic install.
  • Include how to inspect logs safely and what to redact.
  • Include common errors: bad token, missing scope, invalid webhook signature, and wrong API URL.
  • List the tests contributors should run before PR.

Safety notes

Use synthetic examples only. Do not include live credentials, production customer records, private webhook payloads, payment details, or real API keys in public issues, fixtures, logs, screenshots, or PRs.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area: app platformApp registry, install flow, permissions, extension surfaces, connector runtime contractsarea: contributorContribution process, docs, local setup, review flowcommunity editionMust work in the free local/community edition without requiring Posnic ClouddocumentationImprovements or additions to documentationgood first issueGood for newcomershelp wantedExtra attention is neededsize: smallSmall, focused task suitable for a short PR

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions