gitwtfhub

wtf is storeiq?

vinamra1102/storeiq — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · developerComplexity · 3/5Setup · easy

TL;DR

A browser-only rules engine that classifies online shoppers into five behavior types from their activity and suggests the next personalization action.

Mindmap

mindmap
  root((StoreIQ))
    What it does
      Reads shopper events
      Classifies into 5 states
      Suggests next action
    Tech stack
      React
      Tailwind CSS
      lucide-react
    Use cases
      Personalization demo
      Ecommerce prototyping
      Rules engine reference
    Audience
      Frontend developers
      Product teams
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Prototype a shopper personalization feature without any backend.

REASON 2

Study how a rules based classifier can be built as pure functions.

REASON 3

Use the built in simulator to test how different shopping behaviors get classified.

REASON 4

Learn a pattern for tuning weighted rules without touching core logic.

What's in the stack?

ReactTailwind CSSlucide-reactJavaScript

How it stacks up

vinamra1102/storeiq00kaku/gallery-slider-block3rd-eden/ircb.io
Stars0
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-192016-11-16
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity3/52/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Needs only react and lucide-react installed in a React 18 project.

Wtf does this do

StoreIQ is a tool that watches what a shopper does on an online store and tries to figure out what kind of shopper they are. It looks at things like which pages someone visits, what they add to their cart, whether they search for coupons, and whether they finish checking out. Based on that stream of activity, it sorts each shopper into one of five categories: someone just browsing, someone comparing products, someone hunting for discounts, someone who abandoned their cart, or a loyal repeat customer. Once it decides which category fits best, it suggests the next best action a store could take to personalize that shopper's experience. The whole thing runs entirely in the browser, with no server or outside API calls. It comes as a single file built with React and Tailwind CSS, meant to be dropped into a React project, a tool like CodeSandbox, or a similar setup. It needs two packages to work: react and a small icon library called lucide-react. There is no database and no network requests, so all the logic runs on the data you feed it directly. Under the hood, the project is organized so the rules can be changed without touching the core logic. All of the numbers that control the classification, like how much weight each signal carries or how quickly older behavior stops counting, are kept in one place. This means someone could adjust how sensitive the system is without rewriting how it works. The classification itself is calculated the same way every time for the same input, and it includes an evidence trail that shows exactly which signals contributed to the decision, plus a confidence score. It also has a built in simulator, with sample products and pre-built shopper scenarios, so people can test how the classifier reacts to different behavior without needing real store data. The project includes its own checks that verify the underlying logic on its own, separate from the visual interface, plus a browser based check that clicks through the interface itself. There are no listed instructions for connecting this to a real store, so it reads like a demo or foundation piece for future personalization features rather than a ready to use plugin.

Yoink these prompts

Prompt 1
Explain how StoreIQ's classifySession function scores a shopper into one of its five states.
Prompt 2
Show me how to add a sixth shopper state to StoreIQ's classification rules.
Prompt 3
Help me wire StoreIQ's PersonalizationRulesEngine.jsx into a real Vite app.
Prompt 4
Walk me through StoreIQ's evidence trail so I can explain a classification to a non-technical teammate.
Prompt 5
Suggest how to feed real ecommerce event data into StoreIQ instead of the simulator.

Frequently asked questions

wtf is storeiq?

A browser-only rules engine that classifies online shoppers into five behavior types from their activity and suggests the next personalization action.

What language is storeiq written in?

Mainly JavaScript. The stack also includes React, Tailwind CSS, lucide-react.

How hard is storeiq to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is storeiq for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.