brignano 0.0.40 → 1.1.0

package/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  pull_request:
+    paths:
+      - '**/*.ts'
+      - '*.json'
+      - '.github/workflows/ci.yml'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x, 24.x]
+    steps:
+      - uses: actions/checkout@v6
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ matrix.node-version }}
+      - name: Install dependencies
+        run: npm ci
+      - name: Build
+        run: npm run build
+      - name: Test (non-interactive)
+        run: npm test
+        env:
+          CI: true

package/.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
+# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
+
+name: Publish Package
+
+on:
+  workflow_dispatch:
+  release:
+    types: [created]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Use Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '22.x'
+          registry-url: 'https://registry.npmjs.org'
+      - name: Install & Build
+        run: |
+          npm ci
+          npm run build
+      - name: Test (non-interactive)
+        run: npm test
+        env:
+          CI: true
+      - name: Publish to npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --access public

package/dist/banner.js

@@ -0,0 +1,57 @@
+import figlet from 'figlet';
+import gradient from 'gradient-string';
+import { sleep } from './reveal.js';
+// Brand palette — matches brignano.io's electric indigo/violet accent
+// (violet-700 → violet-500 → violet-400). Reads well on a dark terminal.
+const BRAND = ['#6d28d9', '#8b5cf6', '#a78bfa'];
+// A longer ramp with a bright crest (violet-300) used for the shimmer sweep.
+const SHIMMER = [
+    '#5b21b6',
+    '#6d28d9',
+    '#7c3aed',
+    '#8b5cf6',
+    '#a78bfa',
+    '#c4b5fd',
+    '#a78bfa',
+    '#8b5cf6',
+    '#7c3aed',
+    '#6d28d9',
+];
+function bannerArt(text) {
+    try {
+        return figlet.textSync(text, { font: 'ANSI Shadow' });
+    }
+    catch {
+        return text.toUpperCase();
+    }
+}
+function paint(colors, art) {
+    try {
+        return gradient(colors).multiline(art);
+    }
+    catch {
+        return art;
+    }
+}
+// Static gradient banner (used for the non-animated path).
+export function renderBanner(text = 'brignano') {
+    return paint(BRAND, bannerArt(text));
+}
+// Animated splash: a violet highlight sweeps across the letters, then settles on
+// the static brand gradient. Redraws in place via ANSI cursor moves, so it must
+// only be called on a TTY (the caller gates this behind `shouldAnimate`).
+export async function animateBanner(text = 'brignano', frames = 14, frameMs = 70) {
+    const art = bannerArt(text);
+    const lineCount = art.split('\n').length;
+    for (let i = 0; i < frames; i++) {
+        const offset = i % SHIMMER.length;
+        const rotated = SHIMMER.slice(offset).concat(SHIMMER.slice(0, offset));
+        if (i > 0)
+            process.stdout.write(`\u001b[${lineCount}A`);
+        process.stdout.write(`\r${paint(rotated, art)}\n`);
+        await sleep(frameMs);
+    }
+    // Settle on the canonical brand gradient.
+    process.stdout.write(`\u001b[${lineCount}A`);
+    process.stdout.write(`${renderBanner(text)}\n`);
+}

package/dist/card.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { animateBanner, renderBanner } from './banner.js';
+import { renderCard } from './cardBox.js';
+import { funFacts, pick, profile, taglines } from './data.js';
+import { clearConsole, isInteractive, parseFlags, shouldAnimate, shouldFetchLive, } from './env.js';
+import { fetchLive } from './live.js';
+import { buildChoices, sendEmail, viewResume } from './menu.js';
+import { renderQr } from './qrcode.js';
+import { reveal, sleep } from './reveal.js';
+import { writeAndOpenVCard } from './vcard.js';
+function printHelp() {
+    console.log('\nUsage: npx brignano [options]\n');
+    console.log('Options:');
+    console.log('  -h, --help        Show this help');
+    console.log('  -v, --view        Open my resume in your browser');
+    console.log('  -e, --email       Open your mail client to email me');
+    console.log('      --qr          Print a scannable QR code to my website');
+    console.log('      --vcard       Save my contact card (.vcf) and open it');
+    console.log('      --no-animation  Render instantly, skip the reveal animation');
+    console.log('      --no-prompt   Show the card only (non-interactive)');
+    console.log('  -d, --download    Deprecated alias for --view\n');
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    const flags = parseFlags(argv);
+    // Direct-action flags short-circuit the full experience.
+    if (flags.help)
+        return printHelp();
+    if (flags.view || flags.download) {
+        if (flags.download) {
+            console.warn('Note: --download is deprecated; opening the resume instead.');
+        }
+        return viewResume();
+    }
+    if (flags.email)
+        return sendEmail();
+    if (flags.qr) {
+        console.log(await renderQr(profile.website));
+        console.log(chalk.gray(`  ${profile.website}\n`));
+        return;
+    }
+    if (flags.vcard)
+        return writeAndOpenVCard();
+    const animate = shouldAnimate(flags);
+    const interactive = isInteractive(flags);
+    // Kick off the live fetch early (don't await yet) so its timeout budget
+    // overlaps the banner render. Skipped entirely when non-interactive/CI.
+    const livePromise = shouldFetchLive(flags) ? fetchLive() : Promise.resolve(null);
+    clearConsole();
+    // Banner first: an animated violet shimmer when we can animate, otherwise the
+    // static gradient.
+    if (animate) {
+        await animateBanner();
+        await sleep(120);
+    }
+    else {
+        console.log(renderBanner());
+    }
+    // Card, enriched with whatever the (bounded) live fetch returned.
+    const live = await livePromise;
+    const tagline = pick(taglines);
+    await reveal(renderCard({ live, tagline }), 30, animate);
+    console.log(`Tip: ${chalk.cyanBright.bold('cmd/ctrl + click')} the links above.`);
+    console.log(chalk.gray(`     ${pick(funFacts)}\n`));
+    if (!interactive)
+        return;
+    const prompt = inquirer.createPromptModule();
+    const { action } = await prompt([
+        {
+            type: 'list',
+            name: 'action',
+            message: 'What would you like to do?',
+            choices: buildChoices(),
+        },
+    ]);
+    await action();
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Something went wrong: ${message}`);
+    process.exitCode = 1;
+});

package/dist/cardBox.js

@@ -0,0 +1,44 @@
+import boxen from 'boxen';
+import chalk from 'chalk';
+import { profile } from './data.js';
+// Right-aligns labels to a common width so the values line up cleanly.
+const LABEL_WIDTH = 10;
+function label(text) {
+    return chalk.white.bold(text.padStart(LABEL_WIDTH) + ':');
+}
+// Builds the boxen business card. `live` is optional — when absent the live
+// line is simply omitted, so the card looks intentional with or without network.
+export function renderCard({ live, tagline }) {
+    // Violet accent matches brignano.io (violet-400 #a78bfa on dark).
+    const accent = chalk.hex('#a78bfa');
+    const lines = [
+        accent.bold(profile.fullName) + '  ' + chalk.gray(profile.handle),
+        '',
+        `${label('Work')}  ${profile.title} ${chalk.gray('at')} ${chalk
+            .hex('#3A5A78')
+            .bold(profile.org)}`,
+        '',
+        `${label('GitHub')}  ${chalk.gray('https://github.com/')}${chalk.green(profile.username)}`,
+        `${label('LinkedIn')}  ${chalk.gray('https://linkedin.com/in/')}${chalk.blue(profile.username)}`,
+        `${label('Website')}  ${chalk.cyan(profile.website)}`,
+    ];
+    if (live) {
+        lines.push('');
+        const parts = [
+            `${chalk.yellow('★')} ${chalk.bold(live.followers)} followers`,
+            `${chalk.bold(live.publicRepos)} repos`,
+        ];
+        if (live.latestRepo) {
+            parts.push(`latest: ${chalk.green(live.latestRepo.name)}`);
+        }
+        lines.push(`${label('Live')}  ${chalk.gray(parts.join(' · '))}`);
+    }
+    lines.push('', `${label('Card')}  ${chalk.red('npx')} ${chalk.white('brignano')}`, '', chalk.italic(tagline));
+    return boxen(lines.join('\n'), {
+        margin: 1,
+        float: 'center',
+        padding: 1,
+        borderStyle: 'round',
+        borderColor: 'gray',
+    });
+}

package/dist/data.js

@@ -0,0 +1,34 @@
+// Single source of truth for everything the card, vCard, QR and live modules need.
+// Plain (uncolored) values live here; chalk styling is applied at render time.
+export const profile = {
+    firstName: 'Anthony',
+    lastName: 'Brignano',
+    fullName: 'Anthony Brignano',
+    handle: '@brignano',
+    username: 'brignano',
+    title: 'Senior Staff Software Engineer',
+    org: 'The Hartford',
+    email: 'hi@brignano.io',
+    website: 'https://brignano.io',
+    resume: 'https://brignano.io/resume',
+    github: 'https://github.com/brignano',
+    linkedin: 'https://linkedin.com/in/brignano',
+};
+// Rotating taglines — one is picked per run so repeat visitors see variety.
+export const taglines = [
+    'My inbox is always open. Ask a question or just say hi — I read everything.',
+    'Building reliable systems, mentoring engineers, and shipping things that last.',
+    "If it's worth automating, it's worth a clean abstraction. Let's build.",
+    'Self-hoster, spec-driven, and unreasonably fond of a tidy terminal.',
+    'Good engineering is mostly good taste applied consistently. Say hello.',
+];
+// Small easter-egg facts, shown occasionally below the card.
+export const funFacts = [
+    'This card is open source — `npx brignano --help` shows every trick.',
+    'Tip: scan the QR with your phone to save my contact instantly.',
+    'The live stats above are pulled fresh from GitHub (with a strict timeout).',
+];
+// Deterministic-enough pick without Math.random (kept simple + dependency-free).
+export function pick(items, seed = Date.now()) {
+    return items[Math.floor(seed / 1000) % items.length];
+}

package/dist/env.js

@@ -0,0 +1,48 @@
+// Environment + capability detection. Keeps the render logic free of scattered
+// `process.stdout.isTTY` checks and guarantees CI / piped output never hangs.
+export function hasFlag(argv, names) {
+    return names.some((n) => argv.includes(n));
+}
+export function parseFlags(argv) {
+    return {
+        help: hasFlag(argv, ['--help', '-h']),
+        view: hasFlag(argv, ['--view', '-v']),
+        download: hasFlag(argv, ['--download', '-d']),
+        email: hasFlag(argv, ['--email', '-e']),
+        qr: hasFlag(argv, ['--qr']),
+        vcard: hasFlag(argv, ['--vcard', '--save-contact']),
+        noPrompt: hasFlag(argv, ['--no-prompt', '--quiet']),
+        noAnimation: hasFlag(argv, ['--no-animation']),
+    };
+}
+const isCI = () => Boolean(process.env.CI);
+// True only when we can safely show an interactive inquirer prompt.
+export function isInteractive(flags) {
+    return Boolean(process.stdout.isTTY && process.stdin.isTTY && !isCI() && !flags.noPrompt);
+}
+// True only when the reveal animation should play.
+export function shouldAnimate(flags) {
+    return Boolean(process.stdout.isTTY &&
+        !isCI() &&
+        !flags.noPrompt &&
+        !flags.noAnimation &&
+        !process.env.NO_COLOR);
+}
+// True only when we should spend time on a live network fetch.
+export function shouldFetchLive(flags) {
+    return isInteractive(flags);
+}
+export function clearConsole() {
+    const out = process.stdout;
+    if (typeof out.clear === 'function') {
+        try {
+            out.clear();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    if (process.stdout.isTTY) {
+        process.stdout.write('\u001b[2J\u001b[0f');
+    }
+}

package/dist/live.js

@@ -0,0 +1,40 @@
+import { profile } from './data.js';
+const API = 'https://api.github.com';
+const HEADERS = {
+    'User-Agent': 'npx-brignano',
+    Accept: 'application/vnd.github+json',
+};
+// Fetches live GitHub stats with a hard timeout. ANY failure (timeout, offline,
+// non-200, rate-limit, parse error) resolves to null — this never throws and
+// never blocks the card for longer than `timeoutMs`.
+export async function fetchLive(timeoutMs = 1500) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const [userRes, reposRes] = await Promise.all([
+            fetch(`${API}/users/${profile.username}`, {
+                headers: HEADERS,
+                signal: controller.signal,
+            }),
+            fetch(`${API}/users/${profile.username}/repos?sort=updated&per_page=1`, { headers: HEADERS, signal: controller.signal }),
+        ]);
+        if (!userRes.ok || !reposRes.ok)
+            return null;
+        const user = (await userRes.json());
+        const repos = (await reposRes.json());
+        const latest = Array.isArray(repos) ? repos[0] : undefined;
+        return {
+            followers: user.followers ?? 0,
+            publicRepos: user.public_repos ?? 0,
+            latestRepo: latest?.name && latest?.html_url
+                ? { name: latest.name, url: latest.html_url }
+                : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}

package/dist/menu.js

@@ -0,0 +1,73 @@
+import chalk from 'chalk';
+import clipboard from 'clipboardy';
+import open from 'open';
+import { profile } from './data.js';
+import { renderQr } from './qrcode.js';
+import { buildVCard, writeAndOpenVCard } from './vcard.js';
+// --- Action helpers (kept as named functions so flags and the menu share them) ---
+export async function copyEmail() {
+    try {
+        await clipboard.write(profile.email);
+        console.log(`\n${chalk.green('Copied')} ${profile.email} to your clipboard.\n`);
+    }
+    catch {
+        // Clipboard access fails in headless/SSH environments — degrade gracefully.
+        console.log(`\nMy email is ${chalk.green(profile.email)} — drop me a line!\n`);
+    }
+}
+export async function sendEmail() {
+    try {
+        await open(`mailto:${profile.email}`);
+        console.log('\nOpened your mail client — see you in the inbox.\n');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Failed to open mail client: ${message}`);
+        console.error(`Reach me directly at ${profile.email}`);
+    }
+}
+export async function openUrl(url, label) {
+    try {
+        await open(url);
+        console.log(`\nOpened ${label}: ${url}\n`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Failed to open ${label}: ${message}`);
+        console.error(`Here it is: ${url}`);
+    }
+}
+export async function viewResume() {
+    await openUrl(profile.resume, 'resume');
+}
+export async function showContactQr() {
+    const qr = await renderQr(buildVCard());
+    console.log('\nScan to save my contact:\n');
+    console.log(qr);
+}
+export function buildChoices() {
+    return [
+        { name: `Copy my ${chalk.green.bold('email')} to clipboard`, value: copyEmail },
+        { name: `Send me an ${chalk.green.bold('email')}`, value: sendEmail },
+        {
+            name: `Open my ${chalk.green.bold('GitHub')}`,
+            value: () => openUrl(profile.github, 'GitHub'),
+        },
+        {
+            name: `Open my ${chalk.blue.bold('LinkedIn')}`,
+            value: () => openUrl(profile.linkedin, 'LinkedIn'),
+        },
+        { name: `View my ${chalk.magentaBright.bold('resume')}`, value: viewResume },
+        {
+            name: `Save my ${chalk.cyan.bold('contact')} (.vcf)`,
+            value: writeAndOpenVCard,
+        },
+        { name: `Show a ${chalk.yellow.bold('contact QR')} code`, value: showContactQr },
+        {
+            name: 'Just quit',
+            value: () => {
+                console.log('\nHave a great day!\n');
+            },
+        },
+    ];
+}

package/dist/qrcode.js

@@ -0,0 +1,8 @@
+import qrcode from 'qrcode-terminal';
+// Promisified wrapper around qrcode-terminal's callback API. `small: true` keeps
+// the code compact enough for most terminals.
+export function renderQr(text) {
+    return new Promise((resolve) => {
+        qrcode.generate(text, { small: true }, (output) => resolve(output));
+    });
+}

package/dist/reveal.js

@@ -0,0 +1,19 @@
+// Tiny animation helpers — no dependencies. Line-by-line reveal is immune to the
+// ANSI-escape-splitting problem a per-character typewriter would hit, and the
+// total budget stays well under a second.
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// Prints `text` one line at a time, pausing `perLineMs` between lines.
+// When `animate` is false, prints everything at once (CI / piped / --no-animation).
+export async function reveal(text, perLineMs = 35, animate = true) {
+    if (!animate) {
+        console.log(text);
+        return;
+    }
+    const lines = text.split('\n');
+    for (const line of lines) {
+        console.log(line);
+        await sleep(perLineMs);
+    }
+}

package/dist/vcard.js

@@ -0,0 +1,40 @@
+import { writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import open from 'open';
+import { profile } from './data.js';
+// Builds a valid vCard 3.0 string (broadest contact-app compatibility) with the
+// spec-required CRLF line endings.
+export function buildVCard() {
+    const lines = [
+        'BEGIN:VCARD',
+        'VERSION:3.0',
+        `N:${profile.lastName};${profile.firstName};;;`,
+        `FN:${profile.fullName}`,
+        `ORG:${profile.org}`,
+        `TITLE:${profile.title}`,
+        `EMAIL;TYPE=INTERNET,PREF:${profile.email}`,
+        `URL:${profile.website}`,
+        `X-SOCIALPROFILE;TYPE=github:${profile.github}`,
+        `X-SOCIALPROFILE;TYPE=linkedin:${profile.linkedin}`,
+        'NOTE:npx brignano',
+        'END:VCARD',
+    ];
+    return lines.join('\r\n') + '\r\n';
+}
+// Writes the vCard to a temp file and asks the OS to open it (Contacts on
+// macOS/iOS, the default handler elsewhere). On failure, prints the path so the
+// user can open it manually — never throws.
+export async function writeAndOpenVCard() {
+    const file = join(tmpdir(), 'anthony-brignano.vcf');
+    try {
+        writeFileSync(file, buildVCard(), 'utf8');
+        await open(file);
+        console.log(`\nSaved my contact card to: ${file}\n`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`\nCouldn't open the contact card automatically (${message}).`);
+        console.error(`It's saved here — open it manually: ${file}\n`);
+    }
+}

package/package.json

@@ -1,12 +1,20 @@
 {
   "name": "brignano",
-  "version": "0.0.40",
-  "main": "card.js",
+  "version": "1.1.0",
+  "type": "module",
+  "main": "dist/card.js",
+  "engines": {
+    "node": ">=20"
+  },
   "bin": {
-    "anthony": "card.js"
+    "brignano": "dist/card.js"
   },
   "scripts": {
-    "test": "node card.js"
+    "build": "tsc",
+    "dev": "ts-node --esm src/card.ts",
+    "start": "node dist/card.js",
+    "test": "node dist/card.js --no-prompt",
+    "prepare": "npm run build"
   },
   "repository": {
     "type": "git",
@@ -18,16 +26,31 @@
     "url": "https://github.com/brignano/npx-brignano/issues"
   },
   "homepage": "https://github.com/brignano/npx-brignano#readme",
-  "keywords": [],
+  "keywords": [
+    "npx",
+    "business-card",
+    "cli",
+    "brignano",
+    "resume",
+    "vcard"
+  ],
   "description": "A personal card for Anthony Brignano (@brignano)",
   "dependencies": {
-    "boxen": "^4.2.0",
-    "chalk": "^4.1.0",
-    "clear": "^0.1.0",
-    "cli-spinners": "^2.5.0",
-    "inquirer": "^7.3.3",
-    "open": "^7.3.0",
-    "ora": "^5.1.0",
-    "request": "^2.88.2"
+    "boxen": "^6.0.0",
+    "chalk": "^5.2.0",
+    "clipboardy": "^5.0.0",
+    "figlet": "^1.11.0",
+    "gradient-string": "^3.0.0",
+    "inquirer": "^9.2.7",
+    "open": "^8.4.0",
+    "qrcode-terminal": "^0.12.0"
+  },
+  "devDependencies": {
+    "ts-node": "^10.9.1",
+    "typescript": "^5.1.6",
+    "@types/node": "^20.5.1",
+    "@types/inquirer": "^9.0.3",
+    "@types/figlet": "^1.7.0",
+    "@types/gradient-string": "^1.1.6"
   }
 }

package/readme.md

@@ -1,14 +1,81 @@
-# npx_brignano <a href="#"><img src="https://img.shields.io/badge/-npx%20brignano-white?style=flat-square&logo=npm&logoColor=grey" align="right" alt="npm Badge"></img></a>
+# npx-brignano <a href="#"><img src="https://img.shields.io/badge/-npx%20brignano-white?style=flat-square&logo=npm&logoColor=grey" align="right" alt="npm Badge"></img></a>
 
-An interactive shell experience that renders my business card in your terminal.
+An interactive terminal business card for Anthony Brignano. Run it with `npx` to get a gradient ASCII-art intro, a styled card with **live GitHub stats**, and quick actions — copy my email, open my socials, save my contact, or grab a scannable QR code.
+
+## Quick start
 
-👇 just hit 
 ```bash
 npx brignano
 ```
 
-### DEMO
+![](demo.gif)
+
+## What it does
+
+- **Gradient ASCII banner** (`figlet` + `gradient-string`) with a smooth line-by-line reveal animation.
+- **Styled business card** (`boxen` + `chalk`) with name, role, and links.
+- **Live GitHub stats** — follower/repo counts and my latest repo, fetched fresh with a strict ~1.5s timeout. If the network is slow or offline, the card renders instantly and just omits the live line. It never hangs.
+- **Interactive menu** (`inquirer`) with quick actions:
+  - Copy my email to your clipboard
+  - Send me an email (`mailto:`)
+  - Open my GitHub / LinkedIn
+  - View my resume
+  - Save my contact as a `.vcf` (opens in Contacts)
+  - Show a scannable contact **QR code**
+  - Quit
+
+The animation, network fetch, and prompt are all skipped automatically when output isn't a TTY (piped, CI, or `--no-prompt`), so it stays fast and never blocks scripts.
+
+## CLI
+
+Run `npx brignano --help` to see this list.
+
+| Flag | Description |
+|------|-------------|
+| `-h, --help` | Show help and exit. |
+| `-v, --view` | Open my resume in your default browser (`https://brignano.io/resume`). |
+| `-e, --email` | Open your mail client with a new message to `hi@brignano.io`. |
+| `--qr` | Print a scannable QR code to my website and exit. |
+| `--vcard` / `--save-contact` | Save my contact card (`.vcf`) and open it. |
+| `--no-animation` | Render the full card instantly, skipping the reveal animation. |
+| `--no-prompt` | Show the card only and exit (non-interactive). |
+| `-d, --download` | Deprecated alias for `--view`. |
+
+### Examples
+
+```bash
+npx brignano              # full interactive experience
+npx brignano --view       # jump straight to my resume
+npx brignano --qr         # print a QR code to my site
+npx brignano --vcard      # save my contact card
+npx brignano --no-prompt  # card only (useful in CI/scripts)
+```
+
+## Local development
+
+```bash
+git clone https://github.com/brignano/npx-brignano.git
+cd npx-brignano
+npm install
+npm run build
+node dist/card.js
+```
+
+Source lives in `src/` (split into small modules — `card.ts` is the entry/`bin` target) and compiles to `dist/` via `tsc`.
+
+## Prerequisites
+
+- Node.js **>=20** (`npx` ships with npm).
+
+## Notes
+
+- Links printed in the card are cmd/ctrl+clickable in supported terminals.
+- The `--download` flag is deprecated and now opens the resume in your browser instead of writing a local file.
+
+## Credits
+
+Inspired by [anmol098/npx_card](https://github.com/anmol098/npx_card).
 
-![](https://raw.githubusercontent.com/brignano/npx_brignano/main/demo.gif)
+## License
 
-> _100% credit to [anmol098/npx_card](https://github.com/anmol098/npx_card)_
+See `package.json` for license information.