Skip to content

docs: document DATABASE_URL, PORT, and REDIS_URL in CONTRIBUTING.md#9411

Open
pranav-afk wants to merge 1 commit into
makeplane:previewfrom
pranav-afk:docs/9302-contributing-env-vars
Open

docs: document DATABASE_URL, PORT, and REDIS_URL in CONTRIBUTING.md#9411
pranav-afk wants to merge 1 commit into
makeplane:previewfrom
pranav-afk:docs/9302-contributing-env-vars

Conversation

@pranav-afk

@pranav-afk pranav-afk commented Jul 13, 2026

Copy link
Copy Markdown

Description

Documents the required environment variables that new contributors need after setup.sh, so first-time local setup is less likely to fail with unclear connection errors.

  • Explain that setup.sh copies each service .env.example.env and generates the API SECRET_KEY
  • Document DATABASE_URL, REDIS_URL, and PORT with locations and defaults taken from apps/api/.env.example and apps/live/.env.example (aligned with the local Docker Compose stack)
  • List related Postgres/Redis building-block vars and local service ports (web, admin, space, live, API)

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • Feature (non-breaking change which adds functionality)
  • Improvement (change that would cause existing functionality to not work as expected)
  • Code refactoring
  • Performance improvements
  • Documentation update

Screenshots and Media (if applicable)

Test Scenarios

  • Open CONTRIBUTING.md and confirm the Environment variables section appears after the setup.sh step
  • Cross-check table defaults against apps/api/.env.example and apps/live/.env.example
  • Confirm listed local ports match the documented web/admin/space/live/API URLs

References

Summary by CodeRabbit

  • Documentation
    • Expanded project setup instructions with details about environment configuration.
    • Documented key environment variables and their default local values.
    • Added local application port information for Web, Admin, Space, Live, and API services.

New contributors hit connection failures when required env vars from
apps/api and apps/live .env.example files are not explained in the setup
guide. Document what setup.sh copies, the key variables with defaults
that match the local Docker Compose stack, and local service ports.

Fixes makeplane#9302
@CLAassistant

CLAassistant commented Jul 13, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@coderabbitai

coderabbitai Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 66d84178-1ef2-4a21-a2e8-53a9d94101eb

📥 Commits

Reviewing files that changed from the base of the PR and between dc9d80b and 7287372.

📒 Files selected for processing (1)
  • CONTRIBUTING.md
 ________________________________________________________________
< Your exception handling needs a therapist and a boundary plan. >
 ----------------------------------------------------------------
  \
   \   (\__/)
       (•ㅅ•)
       /   づ
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai

coderabbitai Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
putComment timed out

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
CONTRIBUTING.md (1)

76-77: 🎯 Functional Correctness | 🔵 Trivial | ⚡ Quick win

Clarify the execution context for Live’s Redis default.

redis://localhost:6379/ works when Live runs on the host, but not when Live runs inside a container; in that case it should use the Docker service hostname (for example, plane-redis). Please state that this default assumes host-run Live, or document the containerized alternative. (raw.githubusercontent.com)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CONTRIBUTING.md` around lines 76 - 77, The REDIS_URL documentation in
CONTRIBUTING.md currently presents Live’s localhost default without describing
its execution context. Update the REDIS_URL entry to state that
redis://localhost:6379/ applies when Live runs on the host, and document the
containerized alternative using the Docker service hostname such as plane-redis.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@CONTRIBUTING.md`:
- Around line 76-77: The REDIS_URL documentation in CONTRIBUTING.md currently
presents Live’s localhost default without describing its execution context.
Update the REDIS_URL entry to state that redis://localhost:6379/ applies when
Live runs on the host, and document the containerized alternative using the
Docker service hostname such as plane-redis.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 66d84178-1ef2-4a21-a2e8-53a9d94101eb

📥 Commits

Reviewing files that changed from the base of the PR and between dc9d80b and 7287372.

📒 Files selected for processing (1)
  • CONTRIBUTING.md

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Setup docs drift: DATABASE_URL, PORT, REDIS_URL missing from CONTRIBUTING.md

2 participants