Skip to content

README.md

Latest commit

 

History

History
147 lines (114 loc) · 6 KB

README.md

File metadata and controls

147 lines (114 loc) · 6 KB
Raw

Randy Code

Randy Rimbault's personal portfolio — an interactive, map-based site presenting his projects, articles, and integrated developer tools.

Site: randy-code.dev

Overview

The homepage is an interactive world map: each zone is a real, accessible route (Projects, Tools, Articles, About, Lab), not just a visual gimmick. Beyond the map, the site is a standard content/portfolio app — project case studies, a blog, a contact form, and a growing space for developer tools built under the Randy Code brand.

Highlights

  • Interactive homepage — a hub-and-zone world map, fully keyboard- and screen-reader-accessible, with a static fallback for prefers-reduced-motion.
  • Project case studies (/projects) — Liflow (SaaS product), InfraLens (open-source tool), and client work, each with problem/solution/architecture write-ups sourced from the real product, not marketing copy.
  • Articles (/articles) — technical write-ups grounded in what was actually built (e.g. securing a URL analyzer against SSRF), with an RSS feed.
  • Developer tools (/tools) — five focused tools built by Randy Code and usable directly from the site (InfraLens, API Studio, Cron Builder, JSON Studio, MetaLens); InfraLens is the one released under an open-source license.
  • PWA — installable from the browser, with a web app manifest and a cache-first service worker (public/sw.js) for offline resilience.

Developer Tools — InfraLens

InfraLens is an open-source website inspection tool — DNS, TLS, HTTP security headers, infrastructure, and other public technical signals, summarized into one scored, readable report.

It's the first tool integrated natively into Randy Code (migrated from its own standalone repository into app/tools/infralens/ and src/infralens/). Its original docs are preserved under docs/infralens/: README, CHANGELOG, CONTRIBUTING, SECURITY, and LICENSE.

Tech Stack

  • Framework: Next.js 16 (App Router)
  • Language: TypeScript (strict)
  • Styling: Tailwind CSS v4
  • Animation: Framer Motion
  • UI: shadcn/ui, Radix UI primitives
  • Email: Resend (contact form)
  • Testing: Vitest (unit), Playwright (E2E)
  • Deployment: Vercel

See package.json for exact versions and scripts.

Project Structure

app/
  page.tsx                    # Home — interactive world map
  about/                      # About
  articles/                   # Articles (listing + [slug])
  contact/                    # Contact page + form (Resend server action)
  lab/                        # Lab — experiments and internal tooling
  projects/                   # Project case studies (listing + [slug])
  tools/                      # Developer tools
    infralens/                # InfraLens — native routes (analyze, compare, docs, privacy)
    api-studio/               # API Studio — HTTP request client + webhook inspector
    cron-builder/             # Cron Builder — visual cron expression editor
    json-studio/              # JSON Studio — format, validate and explore JSON
    metalens/                 # MetaLens — inspect page metadata, OG/Twitter cards, indexing signals
  api/api-studio/             # Route Handlers — outbound proxy + webhook ingestion
  rss.xml/                    # RSS feed
  sitemap.ts, robots.ts, manifest.ts, opengraph-image.tsx

content/posts/                # Articles, one file per post
src/
  components/                 # Shared UI (map, layout, shadcn/ui primitives)
  lib/                        # Content registries, brand tokens, navigation, JSON-LD
  infralens/                  # InfraLens engine — checks, security/SSRF, DNS, scoring, history
  api-studio/                 # API Studio engine — request execution, codegen, history, webhooks
  cron-builder/               # Cron Builder engine — parsing, validation, next-run calculation
  json-studio/                # JSON Studio engine — parsing, formatting, stats, storage
  metalens/                   # MetaLens engine — HTML parsing, URL resolution, findings

docs/
  infralens/                  # InfraLens developer docs, changelog, security policy, MIT license

Development

Requires pnpm.

pnpm install
pnpm dev

Open http://localhost:3000.

Environment Variables

None are required just to browse the site locally — everything below has a graceful fallback. Set them in .env.local to exercise the real behavior:

  • RESEND_API_KEY — sends real email from the contact form; without it, submissions fail.
  • UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN — enable real rate limiting (InfraLens, MetaLens, contact form, API Studio); without them, the shared limiter (src/lib/rate-limit/) runs allow-all.

Quality Checks

pnpm lint        # ESLint
pnpm typecheck   # tsc --noEmit
pnpm test        # Vitest
pnpm build       # Production build
pnpm check       # lint + typecheck + test + build — the required local/CI gate

pnpm e2e             # Playwright — everything except InfraLens (portfolio + API Studio, Cron Builder, JSON Studio, MetaLens)
pnpm e2e:infralens   # Playwright — InfraLens (rate-limited, single worker)

e2e/e2e:infralens run against a real server and aren't part of pnpm check; they run as separate CI jobs.

Content / Articles

  1. Create content/posts/[slug].ts following an existing post's shape.
  2. Register it in src/lib/blog.ts.
  3. Reading time is computed automatically.

Licensing

Randy Code as a whole is public but does not carry an open-source license — public visibility doesn't grant reuse rights.

InfraLens is the exception: it remains MIT licensed, scoped to docs/infralens/LICENSE. See docs/infralens/README.md for its documentation.