Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

32 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Project Banner

🧠NeuroScan: AI-Powered Brain Tumor Detector Platform

Live Demo Version Status License React Supabase Powered By


πŸš€ Introduction

NeuroScan AI is an AI-powered medical web platform that assists in the early detection and analysis of brain tumors using MRI scan images. The platform combines modern frontend engineering, serverless backend infrastructure, and advanced multimodal AI models to deliver fast, accurate, and explainable results.

The system can determine:

  • Whether a brain tumor is present or absent
  • The type of tumor detected
  • The severity / level of the tumor

In addition, NeuroScan AI generates personalized dietary recommendations, produces downloadable PDF medical reports, securely shares reports with family members, and maintains a complete scan history for long-term monitoring.


✨ Features

Feature Description
🧠 Tumor Detection AI-based classification to detect presence or absence of brain tumors.
🧬 Tumor Type Identification Identifies tumor type (e.g., Glioma, Meningioma, Pituitary).
πŸ“Š Severity & Level Analysis Estimates tumor level for better clinical insight.
🍎 Diet Recommendations AI-generated recommended & avoid-food guidance.
πŸ“„ Downloadable Reports Auto-generated PDF reports with visual insights.
πŸ‘¨β€πŸ‘©β€πŸ‘¦ Family Report Sharing Secure email delivery of reports to family members.
πŸ—‚οΈ Scan History Stores and visualizes historical MRI scans & reports.
🎨 Theme Switching Light/Dark mode using system-aware theming.
πŸ” Secure Data Storage Powered by Supabase authentication & Postgres.
🧠 3D Visualization MRI rendering & overlays using WebGL / Three.js.

πŸ› οΈ Tech Stack

🎨 Frontend

HTML5 React TypeScript Vite React Router shadcn/ui Radix UI Tailwind CSS


πŸ“ Forms & Validation

Formspree React Hook Form Zod


πŸ“Š Data & Charts

TanStack Query Recharts date-fns


🧊 3D Imaging & Reporting

Three.js React Three Fiber Drei html2canvas jsPDF


☁️ Backend & Database

Supabase PostgreSQL Deno Firebase


πŸ€– AI / Machine Learning

Google Gemini Hugging Face Transformers


πŸ”§ NeuroScan AI β€” System Architecture

graph TD
    A[MRI Scan Upload 🧠] --> B[React Web Interface πŸ’»]
    B --> C[Gemini Vision AI]
    C --> D[Tumor Detection & Classification]
    D --> E[Severity Analysis]
    E --> F[Diet Recommendation Engine 🍎]
    D --> G[PDF Report Generator πŸ“„]
    G --> H[Email Sharing Service πŸ“§]
    D --> I[Supabase Database πŸ—„οΈ]
    I --> J[Scan History Dashboard πŸ“Š]
    J --> K[User πŸ‘€]
Loading

File Tree: clarity-scan-ai-main

Root Path: c:\Users\dinesh\Downloads\clarity-scan-ai-main

β”œβ”€β”€ πŸ“ clarity-scan-ai-main
β”‚   β”œβ”€β”€ πŸ“ public
β”‚   β”‚   β”œβ”€β”€ πŸ“ images
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ–ΌοΈ ai-processing.svg
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ–ΌοΈ detailed-report.svg
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ–ΌοΈ tumor-detection.svg
β”‚   β”‚   β”‚   └── πŸ–ΌοΈ upload-mri.svg
β”‚   β”‚   β”œβ”€β”€ πŸ“„ favicon.ico
β”‚   β”‚   β”œβ”€β”€ πŸ–ΌοΈ placeholder.svg
β”‚   β”‚   └── πŸ“„ robots.txt
β”‚   β”œβ”€β”€ πŸ“ src
β”‚   β”‚   β”œβ”€β”€ πŸ“ components
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“ ui
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ accordion.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ alert-dialog.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ alert.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ aspect-ratio.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ avatar.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ badge.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ breadcrumb.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ button.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ calendar.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ card.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ carousel.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ chart.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ checkbox.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ collapsible.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ command.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ context-menu.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ dialog.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ drawer.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ dropdown-menu.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ form.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ hover-card.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ input-otp.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ input.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ label.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ menubar.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ navigation-menu.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ pagination.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ popover.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ progress.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ radio-group.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ resizable.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ scroll-area.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ select.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ separator.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ sheet.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ sidebar.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ skeleton.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ slider.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ sonner.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ switch.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ table.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ tabs.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ textarea.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ toast.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ toaster.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ toggle-group.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ toggle.tsx
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ tooltip.tsx
β”‚   β”‚   β”‚   β”‚   └── πŸ“„ use-toast.ts
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ AnalysisResults.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Brain3D.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ BrainDetector.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Footer.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ MRIUploader.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ NavLink.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Navigation.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ ScanHistory.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ SegmentationOverlay.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Testimonials.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ ThemeToggle.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Timeline.tsx
β”‚   β”‚   β”‚   └── πŸ“„ UserMenu.tsx
β”‚   β”‚   β”œβ”€β”€ πŸ“ hooks
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ use-mobile.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ use-toast.ts
β”‚   β”‚   β”‚   └── πŸ“„ useAuth.tsx
β”‚   β”‚   β”œβ”€β”€ πŸ“ integrations
β”‚   β”‚   β”‚   └── πŸ“ supabase
β”‚   β”‚   β”‚       β”œβ”€β”€ πŸ“„ client.ts
β”‚   β”‚   β”‚       └── πŸ“„ types.ts
β”‚   β”‚   β”œβ”€β”€ πŸ“ lib
β”‚   β”‚   β”‚   └── πŸ“„ utils.ts
β”‚   β”‚   β”œβ”€β”€ πŸ“ pages
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ About.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Auth.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Community.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Contact.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Dashboard.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Detector.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Disclaimer.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ FAQ.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Home.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ HowItWorks.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Index.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ NotFound.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Privacy.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ Profile.tsx
β”‚   β”‚   β”‚   └── πŸ“„ Terms.tsx
β”‚   β”‚   β”œβ”€β”€ πŸ“ styles
β”‚   β”‚   β”œβ”€β”€ πŸ“ utils
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ brainTumorClassifier.ts
β”‚   β”‚   β”‚   └── πŸ“„ pdfReportGenerator.ts
β”‚   β”‚   β”œβ”€β”€ 🎨 App.css
β”‚   β”‚   β”œβ”€β”€ πŸ“„ App.tsx
β”‚   β”‚   β”œβ”€β”€ 🎨 index.css
β”‚   β”‚   β”œβ”€β”€ πŸ“„ main.tsx
β”‚   β”‚   └── πŸ“„ vite-env.d.ts
β”‚   β”œβ”€β”€ πŸ“ supabase
β”‚   β”‚   β”œβ”€β”€ πŸ“ functions
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“ analyze-brain-mri
β”‚   β”‚   β”‚   β”‚   └── πŸ“„ index.ts
β”‚   β”‚   β”‚   └── πŸ“ segment-brain-tumor
β”‚   β”‚   β”‚       └── πŸ“„ index.ts
β”‚   β”‚   β”œβ”€β”€ πŸ“ migrations
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ 20251212072153_af912736-36e3-4609-9ea7-c8df6d6178bc.sql
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ 20251213170654_5f89fac9-04bc-42a3-8a49-0d5e47f0906b.sql
β”‚   β”‚   β”‚   β”œβ”€β”€ πŸ“„ 20251215031032_279fbe2a-b56f-49da-a42f-c261e3d98def.sql
β”‚   β”‚   β”‚   └── πŸ“„ 20251216053430_692b888e-500c-4e53-9faf-57fad3646fc4.sql
β”‚   β”‚   └── βš™οΈ config.toml
β”‚   β”œβ”€β”€ βš™οΈ .gitignore
β”‚   β”œβ”€β”€ πŸ“ README.md
β”‚   β”œβ”€β”€ πŸ“„ bun.lockb
β”‚   β”œβ”€β”€ βš™οΈ components.json
β”‚   β”œβ”€β”€ πŸ“„ eslint.config.js
β”‚   β”œβ”€β”€ 🌐 index.html
β”‚   β”œβ”€β”€ βš™οΈ package-lock.json
β”‚   β”œβ”€β”€ βš™οΈ package.json
β”‚   β”œβ”€β”€ πŸ“„ postcss.config.js
β”‚   β”œβ”€β”€ πŸ“„ tailwind.config.ts
β”‚   β”œβ”€β”€ βš™οΈ tsconfig.app.json
β”‚   β”œβ”€β”€ βš™οΈ tsconfig.json
β”‚   β”œβ”€β”€ βš™οΈ tsconfig.node.json
β”‚   └── πŸ“„ vite.config.ts
β”œβ”€β”€ πŸ“ public
β”‚   └── 🌐 index.html
β”œβ”€β”€ βš™οΈ .firebaserc
β”œβ”€β”€ βš™οΈ .gitignore
β”œβ”€β”€ βš™οΈ firebase.json
β”œβ”€β”€ βš™οΈ package-lock.json
└── βš™οΈ package.json

Contributing 🀝

Contributions are welcome! If you’d like to improve this project or add features, feel free to:

  1. Fork the repo.
  2. Create a new branch.
  3. Submit a pull request.

I appreciate all suggestions for enhancement! πŸ™


Contact Me πŸ“¬

Let’s connect:

m.dinesh.it27@gmail.com LinkedIn Instagram Portfolio GitHub

About

NeuroScan AI is an AI-powered medical web platform that assists in the early detection and analysis of brain tumors using MRI scan images. The platform combines modern frontend engineering, serverless backend infrastructure, and advanced multimodal AI models to deliver fast, accurate, and explainable results.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors