Skip to content

[Feature]: Add "Version and Environment Info" tab to Admin UI #25

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
3 of 10 tasks
crivetimihai opened this issue Jun 2, 2025 · 4 comments
Closed
3 of 10 tasks
Assignees
Labels
enhancement New feature or request frontend Frontend development (HTML, CSS, JavaScript) good first issue Good for newcomers help wanted Extra attention is needed

Comments

@crivetimihai
Copy link
Member

🧭 Type of Feature

  • Enhancement to existing functionality
  • New feature or capability
  • New MCP-compliant server
  • New component or integration
  • Developer tooling or test improvement
  • Packaging, automation and deployment
  • Other (please describe below)

🧭 Epic

Title: Show gateway version and runtime metadata in Admin UI
Goal: Surface /version information inside the visual Admin panel, rather than via raw JSON or bare HTML
Why now: While /version exists (returns JSON and basic HTML), it’s not visible from the main dashboard. A friendly “Version and Environment Info” tab will help users confirm deployment state, runtime, and build info without external tooling.


🙋‍♂️ User Story 1

As a: platform admin or SRE
I want: to view gateway version and runtime details from the Admin UI
So that: I can verify deployment metadata without needing curl or the terminal

✅ Acceptance Criteria

Scenario: View version info from Admin UI
  Given I open the Admin UI
  When I navigate to "Admin > Version and Environment Info"
  Then I see the version, commit, runtime, container, and protocol version

🙋‍♂️ User Story 2

As a: contributor with frontend skills
I want: to fetch version metadata via HTMX and display it in a styled card
So that: I can contribute to the UI without modifying API logic

✅ Acceptance Criteria

Scenario: Add HTMX-based partial rendering
  Given I click on the "Version and Environment Info" tab
  When the section loads
  Then it sends an HTMX request to /version
  And renders a card with app, version, and environment details

📐 Design Sketch

Add a new tab under Admin UI.

Use the /version endpoint to populate a styled info card (Tailwind preferred):

Bonus: include a “Copy to clipboard” button for the JSON block.


🔗 MCP Standards Check

  • Does not affect MCP spec
  • No protocol impact
  • If deviations exist, please describe them below:

🔄 Alternatives Considered

  • Keep version page separate (less visible)
  • Embed version in UI footer (harder to scale, not contextual)
  • Use CLI or curl to check (not UI-friendly)

📓 Additional Context

  • /version already exists and returns JSON like:
{
  "app": "MCP Gateway",
  "version": "main@a1b2c3d",
  "protocol": "2025-03-26",
  "runtime": "Python 3.11 + Gunicorn",
  "container": "Docker"
}
  • Your task is to:

    • Add a new route + template for HTMX fragment rendering of this content
    • Add a tab or panel in the Admin UI that loads it dynamically
    • Use consistent styling (Tailwind, Alpine.js optional)

This is a great first UI feature that blends HTMX, template partials, and FastAPI routes—ideal for frontend-focused contributors.

@crivetimihai crivetimihai added enhancement New feature or request good first issue Good for newcomers help wanted Extra attention is needed triage Issues / Features awaiting triage frontend Frontend development (HTML, CSS, JavaScript) labels Jun 2, 2025
@IrushaBasukala
Copy link

IrushaBasukala commented Jun 8, 2025

Hi @crivetimihai ,

please assign these stories to me .

Thank you!

@manavgup
Copy link
Contributor

See PR #76

@manavgup
Copy link
Contributor

Can we close this now?

@crivetimihai
Copy link
Member Author

Tested and deployed, great work!

@crivetimihai crivetimihai removed the triage Issues / Features awaiting triage label Jun 12, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request frontend Frontend development (HTML, CSS, JavaScript) good first issue Good for newcomers help wanted Extra attention is needed
Projects
None yet
Development

No branches or pull requests

3 participants