⚡ Professional GitHub repo • Astro • MDX • Rich HTML ingestion

Clinical intelligence meets a polished portfolio engine.

This repository is structured as a serious publishing system for healthcare AI, medical knowledge, research pages, visual explainers, and operational dashboards. It is designed for fast static delivery, controlled content growth, and clean GitHub deployment.

View repo structure See workflow
40+
Static routes generated and validated
3
Core content tiers: MDX, Astro, RichContentShell
1
Deterministic ingestion pipeline
100%
Static-build friendly, GitHub-ready architecture

Project overview

A premium Astro-based portfolio and knowledge platform for healthcare AI, medical research, operational intelligence, and visually rich content publishing.

Clinical Intelligence

Pages focused on OPD workflows, medical notes, case sheets, treatment logic, and practical healthcare automation.

OPD AI Case Sheets Treatment Logic

AI Systems

A structured area for AI hub content, lab experiments, automation projects, and model-driven workflows.

AI Hub AI Lab Projects

Research & Knowledge Base

Research notes, surveys, analysis, healthcare economics, visual explainers, and content that needs a disciplined publishing system.

Researches Data Analysis Visual Library

Architecture

The stack is deliberately conservative: Astro for static delivery, MDX for content-heavy pages, component wrappers for repeatable UI, and defensive shells for complex HTML.

Source layer

Markdown, MDX, Astro components, layouts, styles, and content folders live in the repository.

Build layer

`npm run build` generates static routes and the final site output in `dist/`.

Deployment layer

The generated output is suitable for GitHub Pages or any static hosting target.

Content flow deterministic and reversible 
AI-generated HTML
   ↓
input/
   ↓
ingest_html.py
   ↓
src/pages/[category]/[slug].astro
   ↓
RichContentShell.astro
   ↓
npm run build
   ↓
dist/
   ↓
GitHub / hosting

Recommended repository structure

A clear folder model reduces confusion for contributors and makes it obvious what is source, what is generated output, and what is local-only.

GitHub / source

src/, public/, configs, workflows, documentation, and content that should be version-controlled.

Local only

node_modules/, .astro/, dist/, editor state, and any machine-only artifacts.

Junk

Logs, swap files, temporary files, OS clutter, and dead backups that should be ignored or deleted.

Publishing workflow

The workflow is built for controlled growth. Each page type has a preferred path, which prevents accidental design drift.

1
Draft

Write in Markdown, MDX, or raw HTML depending on content complexity.

2
Ingest

Use the HTML ingestion script for AI-generated or messy external content.

3
Validate

Run build checks and confirm links, imports, responsive layout, and route output.

4
Publish

Commit, push, and deploy only after the repository is clean and the build is stable.

Deployment notes

This repo is designed for GitHub-first operations: source in the repository, output generated locally, and live pages served from static hosting.

Install

npm install to restore dependencies from package.json.

Build

npm run build to generate the final static site in dist/.

Deploy

Push source to GitHub and serve the generated output through your chosen static host.