Skip to content

brijoobopanna/AITechPulse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”­ AITechPulse β€” Your Team's Intelligent Technology Heartbeat

AITechPulse Banner

AITechPulse is an AI-driven, interactive technology landscape visualization tool built for modern engineering teams. It empowers teams to track, assess, and communicate technology adoption decisions through an intuitive radar interface β€” giving leadership and developers a shared, living view of their technology stack.

Deploy once, share across your entire team. Everyone with the link sees the same live view, driven by a single Excel file your tech leads maintain.


🌊 Why AITechPulse?

The AI industry is going through a once-in-a-generation transformation. New LLMs, frameworks, platforms, and developer tools are emerging at a pace never seen before β€” what was cutting-edge last quarter may already be superseded. For engineering teams, this creates a real problem:

You can't adopt what you can't track.

Most teams struggle with the same questions:

  • Which new technologies should we be evaluating right now?
  • What have we already tried, and what was the outcome?
  • Which tools are we actively adopting, and which should we phase out?
  • How do we communicate these decisions across 50–100 engineers consistently?

Spreadsheets get buried. Confluence pages go stale. Slack threads disappear. Meanwhile, the technology landscape keeps moving.

AITechPulse solves this by giving your team a single, always-current, visual map of your technology stack β€” organized by category, rated by adoption stage, and updated from one shared Excel file that your tech leads already maintain. Every engineer on the team sees the same view. Every decision is visible. Every quarter's progress is trackable.

It turns the question "What should we be using?" into a 10-second glance instead of a 30-minute meeting.


🎯 How It Works: Blips & Rings

Each insight we share is represented by a blip. Blips may be new to the latest radar volume, or they can move rings as our recommendation has changed.

The rings are:

  • Adopt. Blips that we think you should seriously consider using.
  • Trial. Things we think are ready for use, but not as completely proven as those in the Adopt ring.
  • Assess. Things to look at closely, but not necessarily trial yet β€” unless you think they would be a particularly good fit for you.
  • Hold. Proceed with caution.

✨ Features

Feature Description
Interactive Radar 4-quadrant, 4-ring radar with smooth hover interactions
Excel-Driven Reads from a shared Excel file (Teams / SharePoint / network path)
Config-Based All settings in a single config/aitechpulse.config.json file
Hover Insights Hover a blip to see its name β€” the rest blur for focus
Status Indicators Inner ring = quadrant color; outer ring = movement status
Print to PDF One-click summary export with radar graphic + grouped listing
Team-Ready Built for 50–100 member teams with shared access
Docker Support Production Dockerfile + docker-compose included
Customizable Quadrant names, ring names, colors β€” all configurable
Auto-Refresh Periodically re-fetches data so the view stays current
Search Instantly filter technologies from the header search bar

πŸ—‚οΈ Project Structure

aitechpulse/
β”œβ”€β”€ config/
β”‚   └── aitechpulse.config.json  # ← Main configuration file
β”œβ”€β”€ docker/
β”‚   β”œβ”€β”€ Dockerfile               # Production multi-stage build
β”‚   β”œβ”€β”€ docker-compose.yml       # One-command deployment
β”‚   └── nginx.conf               # Production Nginx config
β”œβ”€β”€ docs/
β”‚   β”œβ”€β”€ banner.svg               # Project banner
β”‚   β”œβ”€β”€ DEPLOYMENT.md            # Deployment guide
β”‚   β”œβ”€β”€ EXCEL_FORMAT.md          # Excel file format spec
β”‚   └── sample-data.xlsx         # Ready-to-use template
β”œβ”€β”€ public/
β”‚   β”œβ”€β”€ index.html               # Entry HTML
β”‚   └── favicon.svg              # App favicon
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ main.jsx                 # React entry point
β”‚   β”œβ”€β”€ App.jsx                  # Root application component
β”‚   β”œβ”€β”€ index.css                # Global styles
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ RadarChart.jsx       # Main radar SVG visualization
β”‚   β”‚   β”œβ”€β”€ BlipDot.jsx          # Individual technology blip
β”‚   β”‚   β”œβ”€β”€ Header.jsx           # App header with controls
β”‚   β”‚   β”œβ”€β”€ QuadrantPanel.jsx    # Sidebar quadrant listing
β”‚   β”‚   β”œβ”€β”€ StatusLegend.jsx     # Legend for statuses
β”‚   β”‚   └── PrintView.jsx        # Print / PDF generation
β”‚   β”œβ”€β”€ hooks/
β”‚   β”‚   └── useRadarData.js      # Data loading & parsing hook
β”‚   └── utils/
β”‚       β”œβ”€β”€ config.js            # Config loader
β”‚       β”œβ”€β”€ geometry.js          # Polar math & layout engine
β”‚       └── colors.js            # Color palette & theming
β”œβ”€β”€ .env.example                 # Environment variable template
β”œβ”€β”€ .gitignore
β”œβ”€β”€ package.json
β”œβ”€β”€ vite.config.js
└── README.md                    # ← You are here

πŸš€ Quick Start

Prerequisites

  • Node.js β‰₯ 18
  • npm β‰₯ 9 (or yarn / pnpm)

1. Clone & Install

git clone https://your-repo-url/aitechpulse.git
cd aitechpulse
npm install

2. Configure

Edit config/aitechpulse.config.json:

{
  "dataSource": {
    "type": "url",
    "url": "https://your-company.sharepoint.com/sites/team/Shared%20Documents/tech-landscape.xlsx"
  }
}

See Excel Format Guide for column specifications.

3. Run Development Server

npm run dev

Open http://localhost:5173 β€” share this URL with your team on the same network.

4. Build & Deploy

npm run build        # β†’ outputs to dist/
npm run preview      # β†’ preview production build locally

🐳 Docker Deployment (Recommended for Teams)

The fastest way to deploy for your whole team:

cd docker
docker-compose up -d --build

This serves AITechPulse on port 8080. Share http://your-server:8080 with the team.

See Deployment Guide for advanced options including Azure App Service, AWS ECS, internal VMs, and CI/CD integration.


πŸ“Š Excel File Format

Your Excel file must have these columns:

Column Required Values Description
name βœ… Free text Technology name (shown on hover)
quadrant βœ… Any 4 unique values Category grouping
ring βœ… Adopt, Trial, Assess, Hold Recommendation level
status βœ… new, Moved in/out, No change Movement indicator

Full spec with examples: EXCEL_FORMAT.md


βš™οΈ Configuration Reference

config/aitechpulse.config.json:

{
  "app": {
    "title": "AITechPulse",
    "subtitle": "Intelligent Technology Landscape",
    "teamName": "Platform Engineering"
  },
  "dataSource": {
    "type": "url",
    "url": "https://your-teams-link/tech-landscape.xlsx",
    "refreshIntervalMinutes": 30,
    "sheetName": "Sheet1"
  },
  "radar": {
    "rings": ["Adopt", "Trial", "Assess", "Hold"],
    "quadrantColors": ["#1abbad", "#f38a3e", "#86b782", "#b32068"]
  },
  "features": {
    "enablePrint": true,
    "enableUpload": true,
    "enableSearch": true
  }
}

πŸ–₯️ Blip Visual Language

Each technology is drawn as concentric circles:

  • Inner circle β€” solid fill, color-coded by quadrant
  • Outer ring β€” based on status:
    • new β†’ full outer ring
    • Moved in/out β†’ half outer ring
    • No change β†’ no outer ring (inner dot only)

Hover: Only the name column is shown. The hovered blip highlights; all others blur. Blips remain static.


πŸ”’ Access & Security

AITechPulse is a static web application. The Excel file is fetched client-side:

  • For SharePoint / Teams URLs: users must be authenticated in their browser
  • For internal URLs: network-level access control applies
  • No data is stored server-side
  • CORS configuration guide included in DEPLOYMENT.md

πŸ› οΈ Tech Stack

  • Vite β€” build tool
  • React 18 β€” UI framework
  • SheetJS β€” Excel file parsing
  • Pure SVG β€” zero charting library dependencies

πŸ“„ License

MIT β€” see LICENSE for details.


AITechPulse β€” See your stack. Shape your future.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors