brignano 1.0.0 → 2.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2020-2026 Anthony Brignano
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

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

@@ -1,126 +1,93 @@
 #!/usr/bin/env node
-import boxen from 'boxen';
 import chalk from 'chalk';
-import inquirer from 'inquirer';
-import open from 'open';
-function clearConsole() {
-    if (typeof process.stdout.clear === 'function') {
-        try {
-            process.stdout.clear();
+import { animateBanner, renderBanner } from './banner.js';
+import { renderCard } from './cardBox.js';
+import { funFacts, pick, profile, taglines } from './data.js';
+import { clearConsole, isInteractive, parseFlags, readVersion, shouldAnimate, shouldFetchLive, unknownFlags, } from './env.js';
+import { fetchLive } from './live.js';
+import { promptForAction, 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, --version       Print the version and exit');
+    console.log('  -r, --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);
+    // Reject typos loudly rather than silently rendering the default card.
+    const unknown = unknownFlags(argv);
+    if (unknown.length > 0) {
+        console.error(`Unknown option: ${unknown.join(', ')}`);
+        console.error("Run 'npx brignano --help' to see the available options.");
+        process.exitCode = 1;
+        return;
+    }
+    const flags = parseFlags(argv);
+    // Direct-action flags short-circuit the full experience.
+    if (flags.help)
+        return printHelp();
+    if (flags.version) {
+        console.log(readVersion());
+        return;
+    }
+    if (flags.view || flags.download) {
+        if (flags.download) {
+            console.warn('Note: --download is deprecated; opening the resume instead.');
         }
-        catch (e) { /* ignore */ }
+        return viewResume();
     }
-    if (process.stdout.isTTY) {
-        process.stdout.write('\u001b[2J\u001b[0f');
+    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 action = await promptForAction();
+    await action();
 }
-clearConsole();
-const prompt = inquirer.createPromptModule();
-const questions = [
-    {
-        type: 'list',
-        name: 'action',
-        message: 'What you want to do?',
-        choices: [
-            {
-                name: `Send me an ${chalk.green.bold('Email')}.`,
-                value: () => sendEmail(),
-            },
-            {
-                name: `View my ${chalk.magentaBright.bold('Resume')}.`,
-                value: () => viewResume(),
-            },
-            {
-                name: 'Just quit.',
-                value: () => {
-                    console.log('Have a good day!\n');
-                },
-            },
-        ],
-    },
-];
-function sendEmail() {
-    open('mailto:hi@brignano.io')
-        .then(() => {
-        console.log('\nDone, see you soon at inbox.\n');
-    })
-        .catch((err) => {
-        console.error('Failed to open mail client:', err && err.message ? err.message : err);
-    });
-}
-function viewResume() {
-    const resumeUrl = 'https://brignano.io/resume';
-    open(resumeUrl)
-        .then(() => {
-        console.log(`\nOpened resume: ${resumeUrl}\n`);
-    })
-        .catch((err) => {
-        console.error('Failed to open resume URL:', err && err.message ? err.message : err);
-    });
-}
-const data = {
-    name: chalk.bold.green('             Anthony Brignano'),
-    handle: chalk.white('@brignano'),
-    work: `Senior Staff Software Engineer ${chalk.white('at')} ${chalk.hex('#3A5A78').bold('The Hartford')}`,
-    github: chalk.gray('https://github.com/') + chalk.green('brignano'),
-    linkedin: chalk.gray('https://linkedin.com/in/') + chalk.blue('brignano'),
-    web: chalk.cyan('https://brignano.io'),
-    npx: chalk.red('npx') + ' ' + chalk.white('brignano'),
-    labelWork: chalk.white.bold('       Work:'),
-    labelGitHub: chalk.white.bold('     GitHub:'),
-    labelLinkedIn: chalk.white.bold('   LinkedIn:'),
-    labelWeb: chalk.white.bold('        Website:'),
-    labelCard: chalk.white.bold('       Card:'),
-};
-const me = boxen([
-    `${data.name}`,
-    '',
-    `${data.labelWork}  ${data.work}`,
-    '',
-    `${data.labelGitHub}  ${data.github}`,
-    `${data.labelLinkedIn}  ${data.linkedin}`,
-    `${data.labelWeb}  ${data.web}`,
-    '',
-    `${data.labelCard}  ${data.npx}`,
-    '',
-    `${chalk.italic("My inbox is always open. Whether you have a")}`,
-    `${chalk.italic("question or just want to say hi, I will try")}`,
-    `${chalk.italic("my best to get back to you! :)")}`,
-].join('\n'), {
-    margin: 1,
-    float: 'center',
-    padding: 1,
-    borderStyle: 'single',
-    borderColor: 'green',
+main().catch((err) => {
+    // Ctrl+C / Esc at the menu is a normal way to leave, not a crash.
+    if (err instanceof Error && err.name === 'ExitPromptError') {
+        console.log('\nHave a great day!\n');
+        return;
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Something went wrong: ${message}`);
+    process.exitCode = 1;
 });
-console.log(me);
-const tip = [`Tip: Try ${chalk.cyanBright.bold('cmd/ctrl + click')} on the links above`, ''].join('\n');
-console.log(tip);
-// Simple argument parsing
-const argv = process.argv.slice(2);
-if (argv.includes('--help') || argv.includes('-h')) {
-    console.log('\nUsage: npx brignano [options]\n');
-    console.log('Options:');
-    console.log('  -h, --help       Show this help');
-    console.log('  -v, --view       Open resume in browser (https://brignano.io/resume)');
-    console.log('  -d, --download   Deprecated: previously downloaded resume — now opens resume in browser');
-    console.log('  -e, --email      Open mail client to email me');
-    console.log('  --no-prompt      Show card only (non-interactive)\n');
-}
-else if (argv.includes('--view') || argv.includes('-v')) {
-    viewResume();
-}
-else if (argv.includes('--download') || argv.includes('-d')) {
-    console.warn('Warning: `--download` is deprecated and now opens the resume in your browser.');
-    viewResume();
-}
-else if (argv.includes('--email') || argv.includes('-e')) {
-    sendEmail();
-}
-else if (argv.includes('--no-prompt') || argv.includes('--quiet')) {
-    console.log('\nExiting in non-interactive mode (--no-prompt).');
-}
-else {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    prompt(questions).then((answer) => answer.action());
-}

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,37 @@
+// 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).
+// The `?? items[0]` fallback is unreachable for a NonEmpty list, but it keeps the
+// return type honest under `noUncheckedIndexedAccess` without an assertion.
+export function pick(items, seed = Date.now()) {
+    const index = Math.floor(seed / 1000) % items.length;
+    return items[index] ?? items[0];
+}

package/dist/env.js

@@ -0,0 +1,85 @@
+// Environment + capability detection. Keeps the render logic free of scattered
+// `process.stdout.isTTY` checks and guarantees CI / piped output never hangs.
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Every accepted token, grouped by the flag it sets. Also drives unknown-flag
+// detection below, so adding a flag here is the only edit needed.
+const FLAG_ALIASES = {
+    help: ['--help', '-h'],
+    version: ['--version', '-v', '-V'],
+    view: ['--view', '--resume', '-r'],
+    download: ['--download', '-d'],
+    email: ['--email', '-e'],
+    qr: ['--qr'],
+    vcard: ['--vcard', '--save-contact'],
+    noPrompt: ['--no-prompt', '--quiet'],
+    noAnimation: ['--no-animation'],
+};
+const KNOWN_TOKENS = new Set(Object.values(FLAG_ALIASES).flat());
+export function hasFlag(argv, names) {
+    return names.some((n) => argv.includes(n));
+}
+export function parseFlags(argv) {
+    return {
+        help: hasFlag(argv, FLAG_ALIASES.help),
+        version: hasFlag(argv, FLAG_ALIASES.version),
+        view: hasFlag(argv, FLAG_ALIASES.view),
+        download: hasFlag(argv, FLAG_ALIASES.download),
+        email: hasFlag(argv, FLAG_ALIASES.email),
+        qr: hasFlag(argv, FLAG_ALIASES.qr),
+        vcard: hasFlag(argv, FLAG_ALIASES.vcard),
+        noPrompt: hasFlag(argv, FLAG_ALIASES.noPrompt),
+        noAnimation: hasFlag(argv, FLAG_ALIASES.noAnimation),
+    };
+}
+// Anything that looks like a flag but isn't one we accept. Returned rather than
+// thrown so the caller decides how loudly to complain.
+export function unknownFlags(argv) {
+    return argv.filter((arg) => arg.startsWith('-') && !KNOWN_TOKENS.has(arg));
+}
+// Read the version straight from the published package.json. It isn't in the
+// `files` list, but npm always ships package.json, and it sits one level above
+// the compiled dist/ directory.
+export function readVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const raw = readFileSync(join(here, '..', 'package.json'), 'utf8');
+        const pkg = JSON.parse(raw);
+        return typeof pkg.version === 'string' ? pkg.version : 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+const isCI = () => Boolean(process.env.CI);
+// True only when we can safely show an interactive 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,43 @@
+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,86 @@
+import { select } from '@inquirer/prompts';
+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');
+            },
+        },
+    ];
+}
+// Shows the action menu and returns the chosen handler. Ctrl+C / Esc throws an
+// `ExitPromptError`, which the entry point treats as a normal exit.
+export async function promptForAction() {
+    const choices = buildChoices();
+    return select({
+        message: 'What would you like to do?',
+        choices,
+        // Default page size is 7, which would hide the last entry behind a scroll.
+        // Show every action at once — the list is short and fixed.
+        pageSize: choices.length,
+    });
+}

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,18 +1,22 @@
 {
   "name": "brignano",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "type": "module",
-  "main": "dist/card.js",
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "bin": {
     "brignano": "dist/card.js"
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc",
-    "dev": "ts-node --esm src/card.ts",
+    "dev": "tsx src/card.ts",
     "start": "node dist/card.js",
+    "lint": "biome check .",
+    "format": "biome check --write .",
     "test": "node dist/card.js --no-prompt",
     "prepare": "npm run build"
   },
@@ -26,18 +30,34 @@
     "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)",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "dependencies": {
-    "boxen": "^6.0.0",
-    "chalk": "^5.2.0",
-    "inquirer": "^9.2.7",
-    "open": "^8.4.0"
+    "@inquirer/prompts": "^8.6.0",
+    "boxen": "^8.0.1",
+    "chalk": "^6.0.0",
+    "clipboardy": "^5.3.2",
+    "figlet": "^1.11.4",
+    "gradient-string": "^3.0.0",
+    "open": "^11.0.1",
+    "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"
+    "@biomejs/biome": "^2.5.10",
+    "@types/figlet": "^1.7.0",
+    "@types/node": "^22.20.1",
+    "tsx": "^4.23.12",
+    "typescript": "^5.9.3"
   }
 }

package/readme.md

@@ -1,66 +1,101 @@
-# 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
 
-An interactive shell experience that renders my business card in your terminal.
+[![npm version](https://img.shields.io/npm/v/brignano?style=flat-square&logo=npm&color=8b5cf6)](https://www.npmjs.com/package/brignano)
+[![npm downloads](https://img.shields.io/npm/dm/brignano?style=flat-square&color=8b5cf6)](https://www.npmjs.com/package/brignano)
+[![CI](https://img.shields.io/github/actions/workflow/status/brignano/npx-brignano/ci.yml?branch=main&style=flat-square&label=ci)](https://github.com/brignano/npx-brignano/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/brignano?style=flat-square&color=8b5cf6)](LICENSE)
+
+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
-
-# 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>
+![](demo.gif)
 
-An interactive terminal business card for Anthony Brignano. Run it with `npx` to view a styled card in your terminal and choose quick actions like emailing or downloading a resume.
+## What it does
 
-Quick start
+- **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
 
-```bash
-npx brignano
-```
+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.
 
-Demo
+## CLI
 
-![](https://raw.githubusercontent.com/brignano/npx_brignano/main/demo.gif)
+Run `npx brignano --help` to see this list.
 
-What it does
+| Flag | Description |
+|------|-------------|
+| `-h, --help` | Show help and exit. |
+| `-v, --version` | Print the installed version and exit. |
+| `-r, --view` / `--resume` | 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`. |
 
-- Renders a boxed, colored business card in the terminal using `boxen` and `chalk`.
-- Presents a small interactive menu (via `inquirer`) with actions:
-	- Send an email (opens your mail client with `mailto:`)
-	- Download the resume (fetches a resume HTML and opens it locally)
-	- Quit
+Unrecognized flags exit with a non-zero status instead of silently falling back
+to the default card.
 
-Files
+> **Note:** as of `2.0.0`, `-v` prints the version (the near-universal CLI
+> convention). The resume now lives at `-r`, and the long `--view` flag is
+> unchanged.
 
-- `card.js` — main CLI script: prints the card and runs the interactive menu.
-- `package.json` — project metadata and `bin` entry used by `npx`.
+### Examples
 
-Usage
+```bash
+npx brignano              # full interactive experience
+npx brignano --view       # jump straight to my resume
+npx brignano --version    # print the version
+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)
+```
 
-- Run directly with `npx brignano` (no install required).
-- Or clone and run locally:
+## Local development
 
 ```bash
-git clone https://github.com/brignano/npx_brignano.git
+git clone https://github.com/brignano/npx-brignano.git
 cd npx-brignano
 npm install
-node card.js
+npm run build
+node dist/card.js
 ```
 
-Prerequisites
+Source lives in `src/` (split into small modules — `card.ts` is the entry/`bin`
+target) and compiles to `dist/` via `tsc`. `npm run dev` runs the TypeScript
+directly through `tsx`; `npm run lint` and `npm run format` use
+[Biome](https://biomejs.dev).
+
+Only `dist/` is published — the tarball is ~8 kB, so `npx brignano` stays a fast
+cold start.
+
+## Prerequisites
 
-- Node.js (tested with Node 14+). `npx` is included with npm.
+- Node.js **>=20** (`npx` ships with npm).
 
-Notes
+## Notes
 
-- When you choose "Download my Resume" the script requests the resume URL and writes `anthony-brignano.html` into the current working directory, then opens it.
-- Links printed in the card may be cmd/ctrl+clickable in supported terminals.
+- 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
+## Credits
 
-This project is inspired by and credited to [anmol098/npx_card](https://github.com/anmol098/npx_card).
+Inspired by [anmol098/npx_card](https://github.com/anmol098/npx_card).
 
-License
+## License
 
-See `package.json` for license information.
+[ISC](LICENSE) © Anthony Brignano

package/.github/workflows/ci.yml

@@ -1,29 +0,0 @@
-name: CI
-
-on:
-  pull_request:
-    paths:
-      - '**/*.ts'
-      - '*.json'
-      - '.github/workflows/ci.yml'
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [18.x, 20.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

@@ -1,32 +0,0 @@
-# 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: '20.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/src/card.ts

@@ -1,133 +0,0 @@
-#!/usr/bin/env node
-
-import boxen from 'boxen';
-import chalk from 'chalk';
-import inquirer from 'inquirer';
-import open from 'open';
-
-function clearConsole(): void {
-  if (typeof (process.stdout as any).clear === 'function') {
-    try { (process.stdout as any).clear(); } catch (e) { /* ignore */ }
-  }
-  if (process.stdout.isTTY) {
-    process.stdout.write('\u001b[2J\u001b[0f');
-  }
-}
-
-clearConsole();
-
-const prompt = inquirer.createPromptModule();
-
-const questions = [
-  {
-    type: 'list',
-    name: 'action',
-    message: 'What you want to do?',
-    choices: [
-      {
-        name: `Send me an ${chalk.green.bold('Email')}.`,
-        value: () => sendEmail(),
-      },
-      {
-        name: `View my ${chalk.magentaBright.bold('Resume')}.`,
-        value: () => viewResume(),
-      },
-      {
-        name: 'Just quit.',
-        value: () => {
-          console.log('Have a good day!\n');
-        },
-      },
-    ],
-  },
-];
-
-function sendEmail(): void {
-  open('mailto:hi@brignano.io')
-    .then(() => {
-      console.log('\nDone, see you soon at inbox.\n');
-    })
-    .catch((err: any) => {
-      console.error('Failed to open mail client:', err && err.message ? err.message : err);
-    });
-}
-
-function viewResume(): void {
-  const resumeUrl = 'https://brignano.io/resume';
-  open(resumeUrl)
-    .then(() => {
-      console.log(`\nOpened resume: ${resumeUrl}\n`);
-    })
-    .catch((err: any) => {
-      console.error('Failed to open resume URL:', err && err.message ? err.message : err);
-    });
-}
-
-const data = {
-  name: chalk.bold.green('             Anthony Brignano'),
-  handle: chalk.white('@brignano'),
-  work: `Senior Staff Software Engineer ${chalk.white('at')} ${chalk.hex('#3A5A78').bold('The Hartford')}`,
-  github: chalk.gray('https://github.com/') + chalk.green('brignano'),
-  linkedin: chalk.gray('https://linkedin.com/in/') + chalk.blue('brignano'),
-  web: chalk.cyan('https://brignano.io'),
-  npx: chalk.red('npx') + ' ' + chalk.white('brignano'),
-
-  labelWork: chalk.white.bold('       Work:'),
-  labelGitHub: chalk.white.bold('     GitHub:'),
-  labelLinkedIn: chalk.white.bold('   LinkedIn:'),
-  labelWeb: chalk.white.bold('        Website:'),
-  labelCard: chalk.white.bold('       Card:'),
-};
-
-const me = boxen(
-  [
-    `${data.name}`,
-    '',
-    `${data.labelWork}  ${data.work}`,
-    '',
-    `${data.labelGitHub}  ${data.github}`,
-    `${data.labelLinkedIn}  ${data.linkedin}`,
-    `${data.labelWeb}  ${data.web}`,
-    '',
-    `${data.labelCard}  ${data.npx}`,
-    '',
-    `${chalk.italic("My inbox is always open. Whether you have a")}`,
-    `${chalk.italic("question or just want to say hi, I will try")}`,
-    `${chalk.italic("my best to get back to you! :)")}`,
-  ].join('\n'),
-  {
-    margin: 1,
-    float: 'center' as const,
-    padding: 1,
-    borderStyle: 'single',
-    borderColor: 'green',
-  }
-);
-
-console.log(me);
-const tip = [`Tip: Try ${chalk.cyanBright.bold('cmd/ctrl + click')} on the links above`, ''].join('\n');
-console.log(tip);
-
-// Simple argument parsing
-const argv = process.argv.slice(2);
-if (argv.includes('--help') || argv.includes('-h')) {
-  console.log('\nUsage: npx brignano [options]\n');
-  console.log('Options:');
-  console.log('  -h, --help       Show this help');
-  console.log('  -v, --view       Open resume in browser (https://brignano.io/resume)');
-  console.log('  -d, --download   Deprecated: previously downloaded resume — now opens resume in browser');
-  console.log('  -e, --email      Open mail client to email me');
-  console.log('  --no-prompt      Show card only (non-interactive)\n');
-} else if (argv.includes('--view') || argv.includes('-v')) {
-  viewResume();
-} else if (argv.includes('--download') || argv.includes('-d')) {
-  console.warn('Warning: `--download` is deprecated and now opens the resume in your browser.');
-  viewResume();
-} else if (argv.includes('--email') || argv.includes('-e')) {
-  sendEmail();
-} else if (argv.includes('--no-prompt') || argv.includes('--quiet')) {
-  console.log('\nExiting in non-interactive mode (--no-prompt).');
-} else {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  prompt(questions as any).then((answer: any) => answer.action());
-}

package/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ES2020",
-    "declaration": false,
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "moduleResolution": "node",
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*"]
-}