Skip to content

feat: added org set up page#753

Merged
DenhamPreen merged 8 commits intomainfrom
kv/org-management
Dec 4, 2025
Merged

feat: added org set up page#753
DenhamPreen merged 8 commits intomainfrom
kv/org-management

Conversation

@keenbeen32
Copy link
Collaborator

@keenbeen32 keenbeen32 commented Dec 4, 2025

Added a page with steps on how to set up an org in the hosted service UI and add members.

Summary by CodeRabbit

  • Documentation
    • Added a new guide for setting up and managing organizations in the Envio hosted service: creating organizations, access controls, adding members, GitHub integration, and step-by-step walkthroughs with images.
  • Navigation
    • Added a Hosted Service "Organisation Setup" entry under the Hosting section to make the new guide discoverable in the docs sidebar.

✏️ Tip: You can customize this high-level summary in your review settings.

@vercel
Copy link

vercel bot commented Dec 4, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
envio-docs Ready Ready Preview Comment Dec 4, 2025 1:35pm

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Dec 4, 2025

Warning

Rate limit exceeded

@keenbeen32 has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 18 minutes and 11 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 3d6df8a and 25d54e6.

⛔ Files ignored due to path filters (1)
  • static/img/org-setup/add-new-organisation-popup.png is excluded by !**/*.png
📒 Files selected for processing (1)
  • docs/HyperIndex/Hosted_Service/organisation-setup.md (1 hunks)

Walkthrough

Adds a new documentation page for "Organisation Setup" in the Hosted Service section and updates the sidebar to include that page under the Hosting category; minor punctuation formatting adjusted in an adjacent sidebar entry.

Changes

Cohort / File(s) Summary
Sidebar Navigation
sidebarsHyperIndex.js
Inserted "Hosted_Service/organisation-setup" into the Hosting category items array; added a trailing comma to the Tutorials/websockets entry.
Documentation
docs/HyperIndex/Hosted_Service/organisation-setup.md
Added new markdown page describing organization creation, access control, and adding members in the Envio hosted service, including illustrative images and step-by-step instructions.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Files are documentation and a small sidebar config change.
  • Review focus: content accuracy in the new doc and correct sidebar path entry.

Possibly related PRs

Suggested reviewers

  • moose-code

Poem

🐰 I hopped through docs to leave a trace,
A guide for orgs in hosted space.
Sidebar blooms with a helpful link,
New members find it in a blink.
thump — celebrate with a carrot wink!

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'feat: added org set up page' directly and specifically describes the main change—adding documentation for organization setup in the hosted service.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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 and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 3

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 712bd34 and 4852efe.

⛔ Files ignored due to path filters (7)
  • static/img/org-setup/add-members-button.png is excluded by !**/*.png
  • static/img/org-setup/add-new-organization-popup.png is excluded by !**/*.png
  • static/img/org-setup/install-envio-deployments-page.png is excluded by !**/*.png
  • static/img/org-setup/members-list-page.png is excluded by !**/*.png
  • static/img/org-setup/not-a-member-error.png is excluded by !**/*.png
  • static/img/org-setup/org-page-after-install.png is excluded by !**/*.png
  • static/img/org-setup/select-org-install-page.png is excluded by !**/*.png
📒 Files selected for processing (3)
  • docs/HyperIndex/Tutorials/org-setup.md (1 hunks)
  • sidebarsHyperIndex.js (1 hunks)
  • src/css/custom.css (1 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/HyperIndex/Tutorials/org-setup.md

[uncategorized] ~21-~21: The official name of this software platform is spelled with a capital “H”.
Context: ...th GitHub 2.1. Click the "Login with Github" button in the top right corner 2.2....

(GITHUB)

🔇 Additional comments (2)
sidebarsHyperIndex.js (1)

103-104: LGTM!

The new tutorial entry is properly positioned and formatted. The trailing comma adjustment on line 103 correctly accommodates the new sidebar item.

src/css/custom.css (1)

433-437: Proper image centering implementation.

The CSS rule correctly centers images within documentation using display: block with auto horizontal margins. Spacing (1.5rem vertical) is consistent with the document's design system.

The AI summary mentions this rule is duplicated in two locations within the file. Please verify whether this duplication exists elsewhere in src/css/custom.css beyond the provided code excerpt, as only one instance appears in the shown content. If duplication is present, consolidate to a single rule to maintain DRY principle.


3.2. In the popup menu, click the **"Install App"** button next to **"+ Add new organisation"**

![Add New Organization Popup](/img/org-setup/add-new-organization-popup.png)
Copy link
Contributor

@coderabbitai coderabbitai bot Dec 4, 2025

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Verify all image files referenced in org-setup.md exist in the repository

# Expected files in /img/org-setup/
expected_images=(
  "add-new-organization-popup.png"
  "install-envio-deployments-page.png"
  "select-org-install-page.png"
  "org-page-after-install.png"
  "not-a-member-error.png"
  "add-members-button.png"
  "members-list-page.png"
)

# Check if the img/org-setup directory exists
if [ ! -d "img/org-setup" ]; then
  echo "❌ Directory img/org-setup does not exist"
  exit 1
fi

# Verify each image exists
missing=0
for img in "${expected_images[@]}"; do
  if [ ! -f "img/org-setup/$img" ]; then
    echo "❌ Missing image: img/org-setup/$img"
    ((missing++))
  else
    echo "✓ Found: img/org-setup/$img"
  fi
done

if [ $missing -eq 0 ]; then
  echo "✅ All images verified successfully"
else
  echo "$missing image(s) missing"
  exit 1
fi

Repository: enviodev/docs

Length of output: 97


Image directory does not exist in the repository.

The tutorial at docs/HyperIndex/Tutorials/org-setup.md references 7 image files from /img/org-setup/, but the img/org-setup/ directory is not present in the repository. The following images are missing:

  • add-new-organization-popup.png
  • install-envio-deployments-page.png
  • select-org-install-page.png
  • org-page-after-install.png
  • not-a-member-error.png
  • add-members-button.png
  • members-list-page.png

Create the img/org-setup/ directory and commit all referenced image files to fix the broken documentation links.

🤖 Prompt for AI Agents
In docs/HyperIndex/Tutorials/org-setup.md around line 31 the tutorial references
images under /img/org-setup/ that are missing from the repo; create the
img/org-setup/ directory at the repository root, add the seven referenced PNG
files (add-new-organization-popup.png, install-envio-deployments-page.png,
select-org-install-page.png, org-page-after-install.png, not-a-member-error.png,
add-members-button.png, members-list-page.png) into that directory with
appropriate filenames, verify the image paths in the markdown match the files,
and commit the new directory and image files so the documentation links resolve.

Copy link
Contributor

Choose a reason for hiding this comment

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

this coderabbit suggestion seems wrong

Copy link
Contributor

Choose a reason for hiding this comment

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

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check the actual directory structure for images
echo "=== Checking for img directory ==="
fd -t d "^img$" -d 3

echo -e "\n=== Looking for org-setup images anywhere in repo ==="
fd "add-new-organization-popup.png"

echo -e "\n=== Checking static directory structure ==="
fd -t d "^static$" -d 3

echo -e "\n=== Looking at how other tutorials reference images ==="
rg -n "!\[.*\]\(.*\.png\)" docs/HyperIndex/Tutorials/ -A 1 | head -30

echo -e "\n=== Checking docusaurus config for static paths ==="
fd "docusaurus.config" -x cat {}

Length of output: 24411


@DenhamPreen You're absolutely right! I apologize for the incorrect suggestion.

The images do exist in the repository and are in the correct location. Here's what I found:

✅ All images are present in static/img/org-setup/:

  • static/img/org-setup/add-new-organization-popup.png
  • And the other 6 referenced images

✅ The markdown paths are correct - in Docusaurus, files in the static/ directory are served at the root path, so:

  • static/img/org-setup/foo.png → accessible as /img/org-setup/foo.png
  • The references like ![Add New Organization Popup](/img/org-setup/add-new-organization-popup.png) are properly formatted

The previous check incorrectly looked for an img/ directory at the repository root instead of understanding Docusaurus's static/ directory convention. The documentation is properly set up and the image links will work correctly.

Copy link
Contributor

Choose a reason for hiding this comment

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

I think this is better under the hosted service section.

I'm also thinking websockets should maybe move to Advanced, even though it's written quite like a tutorial 🤔

@@ -0,0 +1,99 @@
---
id: org-setup
Copy link
Contributor

Choose a reason for hiding this comment

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

Make this organisation-setup will be a better title/slug for seo purposes

Copy link
Contributor

Choose a reason for hiding this comment

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

Could you re-write this as a how to like guide rather than a tutorial


6.4. Click **"Add member"** next to each user you want to grant access to

6.5. Once added, these users can access the organization page and create indexers under the organization
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
6.5. Once added, these users can access the organization page and create indexers under the organization
6.5. Once added, these users can access the organization page and create projects under the organization

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 3

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 3cbef52 and 33e3bfe.

📒 Files selected for processing (2)
  • docs/HyperIndex/Hosted_Service/organisation-setup.md (1 hunks)
  • sidebarsHyperIndex.js (2 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/HyperIndex/Hosted_Service/organisation-setup.md

[uncategorized] ~11-~11: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...tion Setup Use this guide to set up an organization in the Envio hosted service and grant a...

(EN_WORD_COHERENCY)


[uncategorized] ~15-~15: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...cess to your team. --- ## Creating an Organization To create a new organization, open the...

(EN_WORD_COHERENCY)


[uncategorized] ~17-~17: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...eating an Organization To create a new organization, open the Envio hosted service at **htt...

(EN_WORD_COHERENCY)


[uncategorized] ~17-~17: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...ployments** app for the relevant GitHub organization. <div style={{textAlign: 'center'}}> ...

(EN_WORD_COHERENCY)


[uncategorized] ~25-~25: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...pup.png) On GitHub, choose the organization you want to enable and complete the ins...

(EN_WORD_COHERENCY)


[uncategorized] ~25-~25: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...approved, GitHub returns you to the new organization's page in the hosted service UI. <div ...

(EN_WORD_COHERENCY)


[uncategorized] ~40-~40: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...s Control Being a member of the GitHub organization does not automatically grant access...

(EN_WORD_COHERENCY)


[uncategorized] ~40-~40: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...not** automatically grant access to the organization in the Envio hosted service UI. Each me...

(EN_WORD_COHERENCY)


[grammar] ~40-~40: Use a hyphen to join words.
Context: ... access to the organization in the Envio hosted service UI. Each member must be e...

(QB_NEW_EN_HYPHEN)


[uncategorized] ~40-~40: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ... member must be explicitly added by the organization admin. If someone attempts to visit the...

(EN_WORD_COHERENCY)


[uncategorized] ~40-~40: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...admin. If someone attempts to visit the organization URL (e.g., `https://envio.dev/app/<org-...

(EN_WORD_COHERENCY)


[uncategorized] ~52-~52: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...g) --- ## Adding Members The organization admin must add members from the organiz...

(EN_WORD_COHERENCY)


[uncategorized] ~52-~52: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...ization admin must add members from the organization page in Envio. Open the Add Members...

(EN_WORD_COHERENCY)


[uncategorized] ~52-~52: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...e all users associated with your GitHub organization, then grant access by selecting **Add m...

(EN_WORD_COHERENCY)


[uncategorized] ~66-~66: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...d, members should be able to access the organization's page in the hosted service UI and sta...

(EN_WORD_COHERENCY)

🪛 markdownlint-cli2 (0.18.1)
docs/HyperIndex/Hosted_Service/organisation-setup.md

17-17: Bare URL used

(MD034, no-bare-urls)

🔇 Additional comments (2)
sidebarsHyperIndex.js (1)

91-91: LGTM! Placement follows the feedback from previous review.

The new organization setup page is correctly placed in the Hosting section as suggested in the previous review comment.

docs/HyperIndex/Hosted_Service/organisation-setup.md (1)

21-21: > Likely an incorrect or invalid review comment.

Comment on lines +9 to +66
# Organisation Setup

Use this guide to set up an organization in the Envio hosted service and grant access to your team.

---

## Creating an Organization

To create a new organization, open the Envio hosted service at **https://envio.dev** and log in with GitHub. In the top-left menu, select **+ Add new organisation**. This action redirects you to GitHub, where you can install the **Envio Deployments** app for the relevant GitHub organization.

<div style={{textAlign: 'center'}}>

![Add New Organization Popup](/img/org-setup/add-new-organization-popup.png)

</div>

On GitHub, choose the organization you want to enable and complete the installation. Once approved, GitHub returns you to the new organization's page in the hosted service UI.

<div style={{display: 'flex', gap: '1rem', justifyContent: 'center', alignItems: 'center', flexWrap: 'wrap'}}>
<div style={{flex: '1', minWidth: '300px', maxWidth: '500px'}}>
<img src="/img/org-setup/install-envio-deployments-page.png" alt="Install Envio Deployments Page" style={{width: '100%', height: 'auto'}} />
</div>
<div style={{flex: '1', minWidth: '300px', maxWidth: '500px'}}>
<img src="/img/org-setup/select-org-install-page.png" alt="Select Org and Install" style={{width: '100%', height: 'auto'}} />
</div>
</div>

---

## Access Control

Being a member of the GitHub organization **does not** automatically grant access to the organization in the Envio hosted service UI. Each member must be explicitly added by the organization admin. If someone attempts to visit the organization URL (e.g., `https://envio.dev/app/<org-name>`) without being added, they'll see a "You are not a member of the project" message.

<div style={{textAlign: 'center'}}>

![Not a Member Error](/img/org-setup/not-a-member-error.png)

</div>

---

## Adding Members

The organization admin must add members from the organization page in Envio. Open the **Add Members** view to see all users associated with your GitHub organization, then grant access by selecting **Add member** next to each person.

<div style={{textAlign: 'center'}}>

![Add Members Button](/img/org-setup/add-members-button.png)

</div>

<div style={{textAlign: 'center'}}>

![Members List Page](/img/org-setup/members-list-page.png)

</div>

Once added, members should be able to access the organization's page in the hosted service UI and start creating projects!
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Standardize spelling throughout the content.

The document mixes "organization" (US) and "organisation" (UK) spelling. The heading uses UK spelling while the body primarily uses US spelling. Choose one variant and apply it consistently for better readability.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~11-~11: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...tion Setup Use this guide to set up an organization in the Envio hosted service and grant a...

(EN_WORD_COHERENCY)


[uncategorized] ~15-~15: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...cess to your team. --- ## Creating an Organization To create a new organization, open the...

(EN_WORD_COHERENCY)


[uncategorized] ~17-~17: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...eating an Organization To create a new organization, open the Envio hosted service at **htt...

(EN_WORD_COHERENCY)


[uncategorized] ~17-~17: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...ployments** app for the relevant GitHub organization. <div style={{textAlign: 'center'}}> ...

(EN_WORD_COHERENCY)


[uncategorized] ~25-~25: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...pup.png) On GitHub, choose the organization you want to enable and complete the ins...

(EN_WORD_COHERENCY)


[uncategorized] ~25-~25: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...approved, GitHub returns you to the new organization's page in the hosted service UI. <div ...

(EN_WORD_COHERENCY)


[uncategorized] ~40-~40: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...s Control Being a member of the GitHub organization does not automatically grant access...

(EN_WORD_COHERENCY)


[uncategorized] ~40-~40: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...not** automatically grant access to the organization in the Envio hosted service UI. Each me...

(EN_WORD_COHERENCY)


[grammar] ~40-~40: Use a hyphen to join words.
Context: ... access to the organization in the Envio hosted service UI. Each member must be e...

(QB_NEW_EN_HYPHEN)


[uncategorized] ~40-~40: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ... member must be explicitly added by the organization admin. If someone attempts to visit the...

(EN_WORD_COHERENCY)


[uncategorized] ~40-~40: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...admin. If someone attempts to visit the organization URL (e.g., `https://envio.dev/app/<org-...

(EN_WORD_COHERENCY)


[uncategorized] ~52-~52: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...g) --- ## Adding Members The organization admin must add members from the organiz...

(EN_WORD_COHERENCY)


[uncategorized] ~52-~52: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...ization admin must add members from the organization page in Envio. Open the Add Members...

(EN_WORD_COHERENCY)


[uncategorized] ~52-~52: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...e all users associated with your GitHub organization, then grant access by selecting **Add m...

(EN_WORD_COHERENCY)


[uncategorized] ~66-~66: Do not mix variants of the same word (‘organization’ and ‘organisation’) within a single text.
Context: ...d, members should be able to access the organization's page in the hosted service UI and sta...

(EN_WORD_COHERENCY)

🪛 markdownlint-cli2 (0.18.1)

17-17: Bare URL used

(MD034, no-bare-urls)

🤖 Prompt for AI Agents
In docs/HyperIndex/Hosted_Service/organisation-setup.md around lines 9 to 66,
the document mixes "organisation" (UK) and "organization" (US) spellings;
standardize to a single variant (use "organization" throughout) by renaming the
file heading from "Organisation Setup" to "Organization Setup", update any
in-text occurrences, headings, alt text, image captions, and URLs/links in this
range to "organization", and ensure internal consistency of capitalization and
plural forms.

@DenhamPreen DenhamPreen merged commit 356038a into main Dec 4, 2025
3 checks passed
@DenhamPreen DenhamPreen deleted the kv/org-management branch December 4, 2025 13:38
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.

2 participants