npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

mgr-perfect-code

v5.1.1

Published

MGR PERFECT CODE — The Ultimate AI Instruction System. 197 components. Drop into any project, tell any AI to read MGR.md, and watch it build industry-beating software. Works with Claude, GPT, Gemini, Cursor, Windsurf, Copilot, ANY AI.

Readme

MGR PERFECT CODE — THE COMPLETE AI BUILD SYSTEM

© 2025–2026 Money Grind Religion Inc. — Created & Edited by Timebeunus Boyd


What this is: A drop-in folder system that turns ANY AI (Claude, Cursor, Windsurf, Claude Code) into a production-grade engineer that follows YOUR standards, writes REAL code (no mockups), and builds INFINITELY across sessions.

Put this folder in your project → Tell AI to read MGR.md → Build anything.


COMPLETE FILE INVENTORY

MGR_PERFECT_CODE/                          (10,000+ lines total)
│
├── MGR.md                       (81 lines)   — AI Identity & Rules (primary)
├── CLAUDE.md                    (81 lines)   — AI Identity & Rules (legacy)
│   The first file AI reads. Sets MGR standards, copyright,
│   production-only code mandate, no placeholders rule,
│   and auto-creates tracking files.
│
├── PROJECT_INSTRUCTIONS.md      (42 lines)   — Claude Project Settings
│   Paste this into Claude Project's "Custom Instructions" field.
│   Gives every chat in that project MGR standards automatically.
│
├── README.md                    (THIS FILE)   — Master Guide & Instructions
│
├── knowledge/                                 — THE 4 BIBLES
│   ├── MGR_MASTER.md            (630 lines)   — Master Build Bible
│   │   Core standards, architecture patterns, file structure,
│   │   naming conventions, component patterns, state management,
│   │   API design, security, performance, deployment, testing.
│   │   LOAD THIS: Every new project, always.
│   │
│   ├── MGR_UI_BIBLE.md          (861 lines)   — UI/UX Design Bible
│   │   Color systems, typography, spacing, animation, micro-interactions,
│   │   responsive design, dark mode, accessibility, component library,
│   │   design patterns that beat every competitor.
│   │   LOAD THIS: When building frontend/UI.
│   │
│   ├── MGR_3D_BIBLE.md          (464 lines)   — 3D Graphics Bible
│   │   Three.js, React Three Fiber, WebGPU, shaders, physics,
│   │   particle systems, post-processing, performance optimization,
│   │   browser-based 3D rendering techniques.
│   │   LOAD THIS: When building 3D/animation features.
│   │
│   └── MGR_TOKEN_BIBLE.md      (1,094 lines)  — Token Mastery Bible ★ DEEP RESEARCH
│       Context rot science (Chroma 18-model study), Manus production
│       techniques, Cognition/Devin lessons, Anthropic advanced tools,
│       LangChain 4-strategy framework, compaction systems, checkpoints,
│       progressive disclosure, emergency recovery, cost engineering.
│       60+ industry sources. Expert-level.
│       LOAD THIS: When planning sessions or optimizing builds.
│
├── scripts/
│   └── mgr_install.sh           (265 lines)   — Auto-Setup Script
│       Detects OS, installs Node.js/npm/pnpm, sets up Next.js project,
│       installs shadcn/ui + Tailwind + dependencies, creates folder
│       structure, initializes git. One command setup.
│
├── templates/
│   ├── Time_ToDo.md             (32 lines)    — Task Tracker Template
│   │   AI creates this automatically for every project.
│   │   Living document updated at every milestone.
│   │
│   └── Research.md              (44 lines)    — Research Template
│       AI creates this for industry research findings.
│       Populated during deep research phases.
│
├── site/                                      — Landing Page (Deployable)
│   ├── app/page.tsx             — Production landing page (all 10 sections)
│   ├── app/layout.tsx           — Root layout with metadata
│   ├── app/globals.css          — OKLCH design system + aurora bg
│   ├── components/icons.tsx     — Lucide icons barrel export
│   ├── package.json             — Next.js 15 + Framer Motion + Tailwind 4
│   └── next.config.ts           — Standalone output config
│
└── tools/                                     — Future: Custom CLI tools
    (Reserved for MGR automation scripts)

HOW TO USE — STEP BY STEP


OPTION 1: CLAUDE.AI (Phone or Browser) — EASIEST

This is the best option if you're building from your phone or browser.

First-Time Setup (5 minutes, do once):

  1. Go to claude.ai → Click Projects (left sidebar)
  2. Click + New Project → Name it: MyApp - Build
  3. Click Project Knowledge (📎 icon or "Add content")
  4. Upload these files from the knowledge/ folder:
    • MGR_MASTER.md (always upload this)
    • Upload ONE more bible for your build type:
      • Building UI? → MGR_UI_BIBLE.md
      • Building 3D? → MGR_3D_BIBLE.md
      • Planning/optimizing? → MGR_TOKEN_BIBLE.md
  5. Click Custom Instructions → Paste the ENTIRE contents of PROJECT_INSTRUCTIONS.md
  6. Click Save

To Start Building:

Open a new chat inside your project and type:

Build me [describe what you want].
Production code only. No mockups. No placeholders.

That's it. The AI has all MGR standards from the project knowledge.

When Context Gets Full (AI slows down or forgets):

  1. Type: Write a checkpoint of everything we've built to CHECKPOINT.md format
  2. Copy the AI's checkpoint response
  3. Start a new chat in the SAME project
  4. Paste the checkpoint and say: Continue from this checkpoint

To Switch Build Types:

  • Create separate projects: MyApp - UI, MyApp - 3D, MyApp - API
  • Each project uploads the relevant bible
  • Switch projects = clean context with right knowledge

OPTION 2: CLAUDE CODE (Terminal) — MOST POWERFUL

Best for developers with terminal access. Claude Code has built-in compaction, sub-agents, and file system access.

Setup:

  1. Copy the entire MGR_PERFECT_CODE/ folder into your project root:

    cp -r MGR_PERFECT_CODE/ /path/to/your/project/MGR_PERFECT_CODE/
  2. Copy CLAUDE.md to your project root:

    cp MGR_PERFECT_CODE/CLAUDE.md /path/to/your/project/CLAUDE.md
  3. Start Claude Code in your project:

    cd /path/to/your/project
    claude
  4. Claude Code automatically reads CLAUDE.md on start.

To Build:

Read CLAUDE.md then build [describe what you want].
Load knowledge/MGR_MASTER.md for standards.

To Compact (when context fills):

/compact Focus on: completed work, file paths, architecture decisions, remaining tasks.

To Use Sub-Agents:

Use a sub-agent for [specific task] while we focus on [main task].

OPTION 3: CURSOR / WINDSURF (IDE) — FOR IDE USERS

Setup:

  1. Copy MGR_PERFECT_CODE/ folder into your project root

  2. Create .cursorrules (Cursor) or .windsurfrules (Windsurf) in project root:

    Read MGR_PERFECT_CODE/CLAUDE.md for all build standards.
    Follow MGR Perfect Code system by Money Grind Religion Inc.
    Production code only. No mockups. No placeholders.
    When building UI, reference MGR_PERFECT_CODE/knowledge/MGR_UI_BIBLE.md
    When building 3D, reference MGR_PERFECT_CODE/knowledge/MGR_3D_BIBLE.md
  3. Open your IDE and start chatting with the AI.

To Continue Across Sessions: Ask the AI to write CHECKPOINT.md before ending. Next session, tell it to read CHECKPOINT.md and continue.


OPTION 4: ANY OTHER AI (ChatGPT, Gemini, etc.)

The bibles work with any AI. Just paste the relevant content:

  1. Start a new chat
  2. Paste the contents of CLAUDE.md (sets standards)
  3. Paste the contents of whichever bible you need
  4. Give your build instructions

Limitation: Other AIs don't have file system access or compaction. You'll need to manually manage checkpoints by copy-pasting.


THE BUILD WORKFLOW

┌──────────────────────────────────────────────┐
│              MGR BUILD PROTOCOL              │
├──────────────────────────────────────────────┤
│                                              │
│  1. INIT                                     │
│     AI reads CLAUDE.md → Creates tracking    │
│     files (Time_ToDo.md, Research.md)        │
│                                              │
│  2. PLAN                                     │
│     Load MGR_MASTER.md → Architecture →      │
│     Task decomposition → Session plan        │
│                                              │
│  3. BUILD                                    │
│     Load relevant bible → Write production   │
│     code → Update Time_ToDo.md → Compact     │
│     at 60% context usage                     │
│                                              │
│  4. CHECKPOINT                               │
│     Update CHECKPOINT.md → Recite remaining  │
│     tasks (keeps AI focused)                 │
│                                              │
│  5. RESUME (new session)                     │
│     Read CHECKPOINT.md → Load next bible →   │
│     Continue from exact stop point           │
│                                              │
│  6. SHIP                                     │
│     Integration pass → Tests → Deploy to     │
│     free tier → Mark COMPLETE                │
│                                              │
└──────────────────────────────────────────────┘

WHICH BIBLE TO LOAD WHEN

| You're Building... | Load These | |---|---| | New project (anything) | MGR_MASTER.md | | Website / Dashboard / App UI | MGR_MASTER.md + MGR_UI_BIBLE.md | | 3D graphics / Animations | MGR_MASTER.md + MGR_3D_BIBLE.md | | Planning / Optimizing | MGR_TOKEN_BIBLE.md | | Full-stack app | MGR_MASTER.md + MGR_UI_BIBLE.md (Session 1: UI, Session 2: API) |

NEVER load all 4 bibles at once. That wastes 35%+ of your context. Load 1-2 max per session. The Token Bible explains why (Context Rot science).


KEY RULES THE AI FOLLOWS

Once CLAUDE.md is loaded, the AI automatically:

  1. Production code ONLY — No mockups, no placeholders, no "TODO: implement later"
  2. Creates tracking files — Time_ToDo.md, Research.md, CHECKPOINT.md
  3. Uses free-tier stack — Vercel, Supabase, Cloudflare, etc. ($0/month)
  4. MGR copyright only — © Money Grind Religion Inc. on everything
  5. Deep research first — Searches web for industry best practices before building
  6. Never-before-seen features — Aims to beat everything in the industry
  7. AI-powered by default — Integrates free AI/bots for smart UX
  8. Compacts proactively — Saves state before context fills up

EMERGENCY COMMANDS

Paste these exactly if something goes wrong:

Context Full / AI Slowing Down:

EMERGENCY: Write current state to CHECKPOINT.md NOW.
List all modified files. List next 3 tasks.

AI Forgot Instructions:

RESET: Re-read CLAUDE.md and MGR_MASTER.md.
Operating under MGR Perfect Code by Money Grind Religion Inc.
Resume from CHECKPOINT.md.

AI Rushing / Cutting Corners:

SLOW DOWN: You have plenty of context remaining.
Full production code. No abbreviations. Complete the current task fully.

Build Went Wrong:

ROLLBACK: Read CHECKPOINT.md for last good state.
Compare current files. Fix only divergence. No full rebuild.

QUICK START (30 seconds)

If you just want to BUILD something RIGHT NOW:

  1. Go to claude.ai → New chat (no project needed)
  2. Upload CLAUDE.md as a file
  3. Type: Read CLAUDE.md. Then build me [whatever you want]. Production code only.
  4. That's it. The AI has your standards.

For bigger projects, use the Project setup (Option 1) so knowledge persists across multiple chats without re-uploading.


© 2025–2026 Money Grind Religion Inc. — Created & Edited by Timebeunus Boyd