Skip to content

Docs Request: Add documentation for feature flags and environment-based configuration #2864

@surreal-03

Description

@surreal-03

What is the issue you are encountering with the docs?

Environment-based behavior and feature flags in base/web are not documented in a centralized place, making it difficult for contributors to understand why features behave differently across local, staging, and production environments. As a result, developers may accidentally misuse, duplicate, or misconfigure feature flags, increasing debugging time and review complexity.

Links to Impacted Docs

No response

Describe the solution you'd like to see.

  • Add a documentation page or README section titled “Feature Flags & Environment Configuration”.
  • List known flags (names, purpose, default behavior).
  • Explain how flags are loaded (env vars, build-time config) and where they are defined.
  • Provide guidelines for adding new flags and removing old ones.

Additional context

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions