You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
AJ ONeal 49d1d011f2 test browser version, update bower.json 10 years ago
assets refactor as npm and bower packages 10 years ago
src refactor as npm and bower packages 10 years ago
tests test browser version, update bower.json 10 years ago
.gitignore test browser version, update bower.json 10 years ago
LICENSE Initial commit 10 years ago
README.md refactor as npm and bower packages 10 years ago
bower.json test browser version, update bower.json 10 years ago
index.js refactor as npm and bower packages 10 years ago
lists.js refactor as npm and bower packages 10 years ago
package.json refactor as npm and bower packages 10 years ago

README.md

human-readable-ids-js

Use JavaScript to generate human-readable ids from a lists of nouns and adjectives.

Generate ids in the format of adjective-noun-# such as

  • silly-goose-37
  • quick-cobra-15
  • tricky-chicken-23
  • brave-ladybug-90

My problem is that I often want ids that I can type without having to look at it twice (nor telling someone else twice).

I should be able to shout one of these ids across the room to a co-worker or spouse and have them be able to enter it in without any confusion.

Currently the id space is aboutt 100 * 100 * 100. The goal is to have several billion possible combinations.

Install

npm install --save human-readable-ids
bower install --save human-readable-ids

Contributing

Please add more words that fit these criteria

  • Easy-to-spell - such that even my redneck dad can manage
  • Phonetically distinct - no words like bore/boar
  • Few syllables
  • Well-known

All of the words are sorted alphabetically (sort -u) and stored in the *.txt files. The pre-publish script outputs the formatted javascript.

Bad Examples

  • wednesday, hamster, ostrich (difficult to spell)
  • grey, gray, bore, boar (two ways of spelling the same word or sound)
  • prawn (not well-known)

TODO

Acheive 1 trillion ids with a combination such as

number adjective noun verb adverb

And allow choosing various formats based on the desired number of ids.

  • adjective noun number
  • number adjective noun verb