{"id":21339863,"url":"https://github.com/webextensions/simpleid","last_synced_at":"2025-10-09T20:43:01.693Z","repository":{"id":196268921,"uuid":"695467960","full_name":"webextensions/simpleid","owner":"webextensions","description":"Generate simple unique ID strings","archived":false,"fork":false,"pushed_at":"2024-04-24T21:39:36.000Z","size":78,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-12-20T15:50:22.588Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webextensions.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-23T09:21:35.000Z","updated_at":"2024-04-24T21:39:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"a47ca2e1-a692-4a22-9f78-2f2616c4e8ef","html_url":"https://github.com/webextensions/simpleid","commit_stats":null,"previous_names":["webextensions/simpleid"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webextensions%2Fsimpleid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webextensions%2Fsimpleid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webextensions%2Fsimpleid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webextensions%2Fsimpleid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webextensions","download_url":"https://codeload.github.com/webextensions/simpleid/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243817267,"owners_count":20352529,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-22T00:47:47.207Z","updated_at":"2025-10-09T20:43:01.623Z","avatar_url":"https://github.com/webextensions.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# simpleid\nGenerate simple unique ID strings (`simpleid`)\n\n## Rules\n* A `simpleid` is an alphanumeric code (`-` can be used as a separator)\n* A `simpleid` contains 12 key characters (by default)\n* Same character won't repeat consecutively\n* A character will not be followed by the keys to its left or right on a [QWERTY keyboard](https://en.wikipedia.org/wiki/QWERTY)\n* The first character will be an alphabet\n* The following characters are not allowed due to potential of typo: `0`, `o`, `1`, `i` and `l`\n\n## Notes\nCurrently, there are no specific restrictions for:\n* String length (default length is 12 characters)\n* Case-sensitivity (the implementation should handle different cases as same or different)\n* Handling mixed casing (The library generates only lowercase or uppercase strings)\n* Versioning for the definition of a valid `simpleid`\n\n# Usage - via Command line\n\n## Without installing\n\n```sh\n$ npx @webextensions/simpleid\n```\n\n\n## Install and run\n```sh\n$ npm install --global @webextensions/simpleid\n```\n\n```sh\n$ simpleid\nqn3k-vqtw-rp72\n```\n\n```sh\n$ simpleid --case upper\nP6HK-8NRM-RM6G\n```\n\n```sh\n$ simpleid --multiple 5\nf3hw-cmwb-7m6g\nq49j-2tc7-wx8s\nkgvj-n4cj-5xs5\nwjzb-w6jz-fjv8\nqsk4-x59m-pvp4\n```\n\n```sh\n$ simpleid --help\n# Shows the help\n```\n\n# Usage - via Code\n\n## General\n```js\nconst { simpleid } = require('@webextensions/simpleid');\nconst id = simpleid();\nconsole.log(id); // swsk-3c3r-czwt\n```\n\n## Advanced\n```js\nconst {\n    simpleid,\n    simpleidLowerCase,\n    simpleidUpperCase,\n    hyphenateId,\n    unhyphenateId\n} = require('@webextensions/simpleid');\n\nconst\n    id1 = simpleid(),                        // vm6f-85s7-k96p\n    id2 = simpleidLowerCase(),               // qxwz-9r7z-rvtp\n    id3 = simpleidUpperCase(),               // F4QM-2SMW-2J2C\n    withoutHyphen = unhyphenateId(id3),      // F4QM2SMW2J2C\n    withHyphen = hyphenateId(withoutHyphen); // F4QM-2SMW-2J2C\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebextensions%2Fsimpleid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebextensions%2Fsimpleid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebextensions%2Fsimpleid/lists"}