/uses

A list of /uses pages detailing developer setups, gear, software and configs.

← Back to directory

Add Your /uses Page

Got a /uses page? Get listed in the directory by submitting a pull request.

1

Create your /uses page

Publish a page at /uses on your personal website. It should detail the tools, software, hardware, and configurations you use for your work.

Not sure what to include? Here are some ideas:

Hardware

Laptop, monitor, keyboard, mouse, desk, chair, microphone, webcam, headphones

Development

Editor, terminal, font, theme, browser, extensions, CLI tools

Software

Design tools, productivity apps, note-taking, music, communication

Desk Setup

Standing desk, lighting, cable management, accessories, decorations

Hosting & Services

Hosting provider, domain registrar, CI/CD, monitoring, analytics

Check out the existing entries for inspiration.

2

Add your entry to the data file

Fork the awesome-uses repo and add your entry to src/data.js. Add yourself to the top of the array.

{
  name: 'Your Name',
  description: 'Frontend Developer, Cat Enthusiast',
  url: 'https://yoursite.com/uses',
  country: 'πŸ‡ΊπŸ‡Έ',
  computer: 'apple',
  phone: 'iphone',
  twitter: '@yourhandle',
  github: 'yourgithub',
  tags: ['JavaScript', 'TypeScript', 'React', 'VS Code', 'Figma'],
},

Field reference:

FieldRequiredDescription
nameYesYour name
descriptionYesShort tagline about yourself
urlYesFull URL to your /uses page
countryYesFlag emoji for your country
tagsYesArray of tools/technologies you use
computerNoapple, windows, linux, bsd
phoneNoiphone, android, windowsphone, flipphone
githubNoGitHub username (without @)
twitterNoTwitter handle (with @)
mastodonNoFull Mastodon handle (e.g. @user@instance.social)
blueskyNoBluesky handle (without @)
emojiNoAn emoji that represents you
3

Submit a pull request

Commit your changes and open a pull request against the master branch. A maintainer will review and merge it.

Edit data.js on GitHub

Guidelines

  • Your /uses page must be publicly accessible
  • The URL should point directly to your /uses page, not your homepage
  • Use existing tag names where possible β€” check the tags page for common ones
  • One entry per person β€” update your existing entry if your setup changes
  • Keep your description concise (a short tagline, not a bio)