Uses tech platform foundation by wesbos · Pull Request #2070 · wesbos/awesome-uses

wesbos · 2026-02-27T02:22:38Z

This pull request completely rebuilds the uses.tech website to address scalability and usability issues.

Key Changes:

Replatformed: Switched the entire application from Remix/Netlify to Tanstack Start, React, and Vite, targeting Cloudflare Workers for deployment.
Enhanced Navigation: Implemented dedicated permalink routes for each tag (/tags/:tagSlug) and each person (/people/:personSlug).
Improved Filtering: Added a robust, shareable multi-filter URL state on the main directory, supporting filtering by tag, country, device, and search (q).
TypeScript-First: The new codebase is entirely written in TypeScript, with a typed adapter for the existing src/data.js.
Data Management Tools: Introduced several CLI scripts for site maintenance and data enrichment:
- cull-invalid-uses: To remove non-existent /uses pages.
- scrape-uses-to-d1: To scrape /uses page content into a Cloudflare D1 database.
- generate-tag-metadata: To process and generate metadata for tags.
- sync-data-json: To synchronize data.
Cursor Skills: Developed Cursor skills for normalizing tag names and grouping related tags.
Usability: Added features like chunked rendering and "Load more" to handle the large dataset more effectively.
Preserved Core: Maintained the original src/data.js file structure and the existing README GitHub Action, as requested. The original CSS styling has also been preserved.

Why these changes?

The previous site had become too large and difficult to use. This rebuild aims to provide a more performant, maintainable, and user-friendly experience by leveraging a modern stack, introducing better navigation, advanced filtering, and dedicated tools for data curation.

How to Test/Run:

Clone the repository.
npm install
npm run dev
Open http://localhost:3000 in your browser.

Useful CLI Commands:

npm run typecheck
npm test
npm run build
npm run cull -- --limit 50 (dry run)
npm run cull -- --apply (rewrite src/data.js)
npm run scrape -- --db uses-tech-scrapes --limit 50
npm run generate:tag-metadata

Caveats/Follow-ups:

Update the D1 database ID in wrangler.jsonc for your deployment environment.
The application uses a generated src/generated/people.json snapshot to ensure Cloudflare/ESM compatibility while respecting the data.js contract.

Add your name to verify: Cursor

Co-authored-by: Wes Bos <wes@wesbos.com>

cursor · 2026-02-27T02:22:39Z

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}

Co-authored-by: Wes Bos <wes@wesbos.com>

cloudflare-workers-and-pages · 2026-02-27T02:36:59Z

Deploying with Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	uses-tech	`0f29083`	Commit Preview URL Branch Preview URL	Mar 07 2026, 03:36 AM

Co-authored-by: Wes Bos <wes@wesbos.com>

wesbos · 2026-02-27T02:48:02Z

@cursoragent can you add a button to scrape the pages? I don't care about auth just yet.

cursor · 2026-02-27T02:48:08Z

Absolutely — here’s a good reply you can post on the PR:

Yep, I can add that.
I’ll add a “Scrape pages” button in the UI (no auth for now, as requested) that triggers a server-side scrape + D1 upsert flow.
I’ll keep the existing CLI scripts too, so both options remain available.

I’ll wire in basic status feedback (running/success/error) so it’s clear when scraping finishes.

Co-authored-by: Wes Bos <wes@wesbos.com>

The title attribute was on the Link wrapper but the img filled the clickable area, preventing the browser tooltip from showing. Moved title onto the img element and added a title to the +N overflow badge listing hidden names. Made-with: Cursor

- Remove people count and FacePile from TagCard header - Skip articles (the/a/an) in groupByBrand to prevent incorrect grouping - Add HIDDEN_TAGS constant and filter hidden tags from /tags page Made-with: Cursor

- Install drizzle-orm and drizzle-kit with better-sqlite3 for studio - Add Drizzle schema (schema.ts) for all tables including new items table - Rewrite d1.ts from raw D1 SQL to Drizzle query builder - Add new DB helpers: getErrorPeople, deletePersonItems, insertPersonItems, getScrapedContent, getAllUniqueItems, item enrichment CRUD - Add migration 0007 for the items enrichment table - Add drizzle.config.ts with auto-discovery of local D1 sqlite file - Add db:studio, db:generate, db:migrate, db:migrate:remote scripts - Update d1.test.ts for Drizzle compatibility - Clean up amazon.ts, analytics.ts, reclassify.ts env resolution Made-with: Cursor

- Add checkboxes and select-all to dashboard people table - Add Scrape Selected button that re-scrapes and re-extracts items - Import $reScrapeAndExtract server function for on-demand scraping Made-with: Cursor

- New /items-dashboard route with table of all unique items - Filter by enrichment status and item type - Select items and batch-enrich via OpenAI (type, description, URL) - Memoized rows and infinite scroll for performance with large datasets Made-with: Cursor

- New /wall-of-shame route listing people with error/404 status - Homepage fetches error slugs and filters them from the people grid Made-with: Cursor

- New Nav component with links to Home, Tags, Dashboard, Items, Wall of Shame - Active state highlighting based on current pathname - Integrated between Header and Outlet in root layout Made-with: Cursor

- Add $reScrapeAndExtract, $enrichItems, $getItemsDashboard, $getErrorPeople, $getErrorSlugs server functions - Show item type badge, description, and URL on item detail page - Only show Amazon product matches for items typed as "product" - Include auto-generated route tree updates for new routes Made-with: Cursor

Move data fetching from client-side useEffect into a TanStack Router loader so the item detail page is fully server-rendered without a loading spinner. Also return the object directly from $getItemDetail instead of JSON.stringify. Made-with: Cursor

- Create shared SEO helper (src/lib/seo.ts) with buildMeta() and ogImageUrl() - Add workers-og powered /og endpoint for dynamic Open Graph images - Add head() with title, description, OG, and Twitter Card tags to: root, index, people, items, tags, tag detail, and like routes - Add canonical URLs to all routes Made-with: Cursor

Replace the FacePile on item detail pages with a grid of PersonMiniCard components that show avatar, name, and bio for each person using the item. Made-with: Cursor

Unify avatar URL generation into a single getAvatarUrl() in lib/avatar.ts, used by both client components and server functions. Build a chained fallback: X -> GitHub -> Bluesky -> Mastodon -> website domain, using unavatar's ?fallback= parameter for graceful degradation. Made-with: Cursor

- Add vectorize binding to wrangler.jsonc for uses-similarity index - Create scripts/vectorize-profiles.ts to embed scraped /uses content via OpenAI text-embedding-3-small and upsert to Vectorize - Add $getSimilarPeople server function that queries Vectorize for nearest neighbors by cosine similarity - Display "Similar People" section on person pages using PersonMiniCard Made-with: Cursor

Create an interactive skill in .agents/uses-page/ that guides users through documenting their developer setup. Includes a system info detection script and a structured interview process covering hardware, software, and workflow, with export to markdown, HTML, JSX, or rich text. Made-with: Cursor

Create a step-by-step guide for adding your own /uses page to the directory: create your page, add your entry to data.js, and submit a PR. Includes field reference table, content ideas, and guidelines. Made-with: Cursor

List every technology powering the /uses directory: TanStack Start, Cloudflare Workers/D1/Vectorize, Drizzle ORM, Tailwind CSS, shadcn/ui, OpenAI, workers-og, unavatar, and more. Add SEO meta tags. Made-with: Cursor

Add a prominent hero section with the /uses title, description, people count, and a CTA linking to the /add page. Fix the "Add yours" link to point to the internal /add route instead of GitHub. Made-with: Cursor

- Add Avatar, Facts, SocialLinks, UsesUrl, ItemIcon, PersonCard components - Add fetch-item-images script and generated items data - Add DirectoryFacts type and getDirectoryFacts to data layer - Update dashboard with improved layout - Update d1 queries and server functions - Update route tree, package.json, and footer - Add todo.md Made-with: Cursor

- Added new dependencies: @radix-ui/react-popover, @radix-ui/react-tooltip, cmdk, ml-kmeans, shaders, and umap-js. - Removed unused dependencies: ml-kmeans and umap-js from package.json. - Updated styles for the body background in styles.css. - Enhanced FacePile component with tooltips for better user experience. - Introduced lazy loading for ShaderBackground in the root route. - Improved admin tags page with a new category combobox using popover and command components. - Cleaned up console logs in the Amazon search function. Made-with: Cursor

User item tag system

cursoragent and others added 9 commits February 27, 2026 01:35

Fix data.js module export for Vite compatibility

fe40732

Co-authored-by: Wes Bos <wes@wesbos.com>

feat: rebuild app on tanstack start with cloudflare

738b4ef

Co-authored-by: Wes Bos <wes@wesbos.com>

feat: add data ops cli tools and tag normalization skills

5ac2ef8

Co-authored-by: Wes Bos <wes@wesbos.com>

fix: keep data.js commonjs with generated app snapshot

033bd3d

Co-authored-by: Wes Bos <wes@wesbos.com>

feat: chunk person rendering with load-more grid

46bd90c

Co-authored-by: Wes Bos <wes@wesbos.com>

fix: preserve unprocessed entries in cull workflow

5dc1749

Co-authored-by: Wes Bos <wes@wesbos.com>

test: cover scraper parsing and sql serialization helpers

6b5fa33

Co-authored-by: Wes Bos <wes@wesbos.com>

fix: reset chunked list when filter results change

7d5ac62

Co-authored-by: Wes Bos <wes@wesbos.com>

test: add filter parsing and d1 lookup unit coverage

f52fbac

Co-authored-by: Wes Bos <wes@wesbos.com>

cursor Bot marked this pull request as ready for review February 27, 2026 02:25

cursoragent and others added 2 commits February 27, 2026 02:31

chore: set cloudflare d1 database id

4a00b5c

Co-authored-by: Wes Bos <wes@wesbos.com>

chore: remove stale pnpm lockfile for CI

1924da6

Co-authored-by: Wes Bos <wes@wesbos.com>

cursoragent and others added 2 commits February 27, 2026 02:40

chore: require node 22 for cloudflare builds

fa4a7e5

Co-authored-by: Wes Bos <wes@wesbos.com>

chore: switch project workflows to pnpm

64e3601

Co-authored-by: Wes Bos <wes@wesbos.com>

feat: scrape profile data on-demand when missing

2ffa336

Co-authored-by: Wes Bos <wes@wesbos.com>

Repository owner deleted a comment from cursor Bot Feb 27, 2026

cursoragent and others added 10 commits February 27, 2026 18:12

fix: show tags on tag pages and remove filter form

916ad8e

Co-authored-by: Wes Bos <wes@wesbos.com>

fix: restore favicon icons socials and full person list

e71a816

Co-authored-by: Wes Bos <wes@wesbos.com>

chore: enable wrangler invocation logs

a45336d

Co-authored-by: Wes Bos <wes@wesbos.com>

feat: consolidate /like routes and restore legacy icons

9fcf142

Co-authored-by: Wes Bos <wes@wesbos.com>

chore: enable wrangler traces

c59b7c8

Co-authored-by: Wes Bos <wes@wesbos.com>

adds github IDs to data.js

d0742e4

categories, tags and a whole bunch of stuff

377e940

change to tailwind

9b56b7b

new classifier

a870600

scriptssss

1f3beaf

cursoragent and others added 30 commits March 5, 2026 04:54

Add D1 helpers for item/tag details and scrape events

c6f63e2

Co-authored-by: Wes Bos <wes@wesbos.com>

Add analytics and Amazon integration server modules

537a294

Co-authored-by: Wes Bos <wes@wesbos.com>

Add clickable tag and item discovery pages

67cab9b

Co-authored-by: Wes Bos <wes@wesbos.com>

Add admin reclassify and merge item controls

c1ca074

Co-authored-by: Wes Bos <wes@wesbos.com>

Finish admin controls and company logo enhancements

42f4857

Co-authored-by: Wes Bos <wes@wesbos.com>

Fix tag card cleanup, article grouping, and add hidden tags support

436fe37

- Remove people count and FacePile from TagCard header - Skip articles (the/a/an) in groupByBrand to prevent incorrect grouping - Add HIDDEN_TAGS constant and filter hidden tags from /tags page Made-with: Cursor

Add re-scrape selected people with item re-extraction

c31eac7

- Add checkboxes and select-all to dashboard people table - Add Scrape Selected button that re-scrapes and re-extracts items - Import $reScrapeAndExtract server function for on-demand scraping Made-with: Cursor

Add wall of shame page and filter error people from homepage

8c2210f

- New /wall-of-shame route listing people with error/404 status - Homepage fetches error slugs and filters them from the people grid Made-with: Cursor

Add global navigation bar to root layout

c503511

- New Nav component with links to Home, Tags, Dashboard, Items, Wall of Shame - Active state highlighting based on current pathname - Integrated between Header and Outlet in root layout Made-with: Cursor

remove skills

80286a0

Add PersonMiniCard component for richer people display on item pages

a3631b1

Replace the FacePile on item detail pages with a grid of PersonMiniCard components that show avatar, name, and bio for each person using the item. Made-with: Cursor

Add /add page with instructions for submitting a /uses page

030ef98

Create a step-by-step guide for adding your own /uses page to the directory: create your page, add your entry to data.js, and submit a PR. Includes field reference table, content ideas, and guidelines. Made-with: Cursor

Add /uses page documenting the site's own tech stack

e609585

List every technology powering the /uses directory: TanStack Start, Cloudflare Workers/D1/Vectorize, Drizzle ORM, Tailwind CSS, shadcn/ui, OpenAI, workers-og, unavatar, and more. Add SEO meta tags. Made-with: Cursor

Add landing hero to the home page

7443968

Add a prominent hero section with the /uses title, description, people count, and a CTA linking to the /add page. Fix the "Add yours" link to point to the internal /add route instead of GitHub. Made-with: Cursor

move scripts into app

3e1770a

refactor into smaller files

85c5823

admin routes

4eb2da3

rejigging

e1bf13d

Merge pull request #2076 from wesbos/cursor/user-item-tag-system-473c

0f29083

User item tag system

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uses tech platform foundation#2070

Uses tech platform foundation#2070
wesbos wants to merge 54 commits into
masterfrom
cursor/uses-tech-platform-foundation-bd25

wesbos commented Feb 27, 2026

Uh oh!

cursor Bot commented Feb 27, 2026

Uh oh!

cloudflare-workers-and-pages Bot commented Feb 27, 2026 •

edited

Loading

Uh oh!

wesbos commented Feb 27, 2026

Uh oh!

cursor Bot commented Feb 27, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

wesbos commented Feb 27, 2026

Uh oh!

cursor Bot commented Feb 27, 2026

Uh oh!

cloudflare-workers-and-pages Bot commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying with Cloudflare Workers

Uh oh!

wesbos commented Feb 27, 2026

Uh oh!

cursor Bot commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

cloudflare-workers-and-pages Bot commented Feb 27, 2026 •

edited

Loading

cursor Bot commented Feb 27, 2026 •

edited

Loading