A Short Guide to Component Naming

by Angela Fisher, Front-end Developer

1. Brevity is Key

Time is scarce, don’t waste it typing out long, descriptive component names. One approach is to give them short, cryptic names that only you will understand.

Need a button? Call it "btn". A modal? How about "md"? You’ll save precious minutes per day and you’ll get the added benefit of being the only person in the codebase who knows where anything is. This is called job security.

2. Rank High in Search

When working in large repos with lots of collaborators, it’s important that your component ranks high when people search for anything.

One way to stand out is to include all the possible search terms in your component name. Instead of “SignInButton” you might want call it “SignInButtonAuthenticationCookieUserLogIn” which will ensure that it is returned in almost any related search result.

3. Mix Languages

If you work remotely, it’s likely you are on a global team and yet all your components have English names. This slows down your non-english colleagues considerably so you should allow them to use their native tongue when naming components.

You can create an index file that maps all the different languages within your repo. Need a dropdown? Look for “Desplegable”. A form? Search “Форма”. You’ll learn multiple new languages while being more inclusive to your colleagues.

More articles

O Futuro do Desenvolvimento Web: Nossas Previsões para 2023

Vamos explorar as últimas tendências em desenvolvimento web e compartilhar algumas previsões sobre como elas moldarão a indústria no próximo ano.

Read more

3 Lições que Aprendemos ao Voltar ao Escritório

No início deste ano, tomamos a decisão ousada de fazer todos voltarem ao escritório em tempo integral após dois anos trabalhando de uma mesa improvisada no canto do quarto.

Read more

Conte-nos sobre o seu projeto

Nossos escritórios

  • Itapetininga
    Vila Arruda, Itapetininga - SP
    18212-090