Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Add a UUID Generator & Inspector tool (v4 and v7)

Aperta
  • Qualcosa non va?
#83 9 commenti 0 reazioni 1 assegnatario Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@srujankaleru2007 ci sta già lavorando.

Dal 22/10/2026.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
61/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
nextjs, react, typescript
Ambito
developer-experience, frontend, testing, tooling

Direzione di ricerca

Start with lib/tools.ts and the Tool interface, then use app/(tools)/base64/ as the route and UI reference; read the README's "Add a tool" section for the checklist. Implement and test pure UUID logic in lib/uuid.ts and lib/__tests__/uuid.test.ts, then build the route /uuid-generator and its client UI. Done means the scoped v4/v7 generation and inspection work, the listed tests pass, and npm run lint && npm run test && npm run build succeeds.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

enhancement good first issue hacktoberfest new tool

Generate random (v4) and time-ordered (v7, RFC 9562) UUIDs locally, and inspect a pasted UUID to see its version, its variant and, for v7, the timestamp inside it.

Route: /uuid-generator

Suggested registry values: title UUID Generator & Inspector, tagline Identifiers, heroHeading UUID Generator & Inspector with heroDim &, features ["UUID v4", "UUID v7", "Bulk", "Inspect", "No hyphens"].

Core logic in lib/uuid.ts

  • uuidV4(random: Uint8Array) and uuidV7(nowMs: number, random: Uint8Array). They take randomness and time as arguments so they're easy to test; the UI passes bytes from crypto.getRandomValues.
  • v7 layout: a 48-bit big-endian Unix timestamp in milliseconds, version bits 0111, variant bits 10, and the rest random
  • formatUuid(bytes, { uppercase, hyphens })
  • inspectUuid(text) returning { ok, version, variant, timestampMs? }, recognising the nil and max UUIDs; malformed input returns ok: false

v1 scope

  • Generate 1 to 100 UUIDs with a v4 / v7 toggle
  • Uppercase and no-hyphens toggles
  • Copy all
  • An inspector input

Out of scope for v1: v1, v3, v5, v6, ULID and nanoid (good follow-up issues).

Where to look

  • lib/tools.ts (the registry and the Tool interface)
  • app/(tools)/base64/ (a complete tool to copy the structure from)
  • The "Add a tool" section of the README

Acceptance criteria

  • Tests: correct version nibble and variant bits for v4 and v7, the v7 timestamp round-trips through inspectUuid for a fixed nowMs, two v7 UUIDs with increasing time sort in order, formatting options, malformed input rejected, and the nil UUID detected
  • UI as scoped above
  • The standard new-tool checklist below is complete

Standard new-tool checklist

Everything (home grid, metadata, JSON-LD, OG image, sitemap, manifest, command palette) is driven by the registry in lib/tools.ts, so a new tool is mostly one registry entry plus a route.

  • Add an entry to TOOLS in lib/tools.ts filling every field of the Tool interface (lib/tools.ts:19-52). Use applicationCategory: "DeveloperApplication", reuse the CTA_PROJECTS / CTA_CONTACT constants for the CTA links, and set sitemapPriority: 0.9 like the other tools.
  • Pick accentVar from the accent variables in app/globals.css (the list is under "Adding a tool" in CONTRIBUTING.md). Take one that no tool uses yet, or the one the fewest tools have if they're all taken. Don't use --rose, it's the color of error messages. Set accentHex to that variable's dark-theme value. heroDim must be "" or a substring of heroHeading.
  • Write 3 or 4 FAQs (3 renders as a 3-column grid, see components/shared/ToolPageLayout.tsx:25). Keep metaTitle under 60 characters and metaDescription around 150 to 160.
  • Keep features and ogDescription to plain Latin text and punctuation. The social card font is a subset with no arrow or symbol glyphs (lib/og.tsx:33-36).
  • Create app/(tools)/<slug>/page.tsx, <Name>Client.tsx (with "use client"), and opengraph-image.tsx. Copy page.tsx and opengraph-image.tsx from app/(tools)/base64/ and change the slug.
  • Put all pure logic in lib/<name>.ts (no React, no DOM) with tests in lib/__tests__/<name>.test.ts. Tests can import with @/ like the app does (vitest.config.ts has the alias).
  • Nothing leaves the browser: no network calls with user input, no analytics, no third-party scripts (the CSP in middleware.ts blocks external scripts anyway).
  • Reuse shared pieces: CopyButton, useToast, and optionally useRegisterCommands for command palette actions (example in app/(tools)/base64/Base64Client.tsx:43-53).
  • Every input has a visible label or an aria-label, the tool works with the keyboard alone, and it looks right in both light and dark themes.
  • Add the tool to the "Which tool?" dropdown in .github/ISSUE_TEMPLATE/bug_report.yml.
  • npm run lint && npm run test && npm run build passes.

One new tool per contributor, so more people get a chance. Add your registry entry at the end of TOOLS and rebase on develop before asking for review, since other new tools will touch the same file.

Want to work on this? Comment below and I'll assign it to you. Please take one issue at a time, branch off develop, and open your PR against develop with Closes #83 in the description.

Lingua principale
TypeScript
Stelle
1
Fork
9
Merge medio
9h 9m
PR unite (30g)
118

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di codercops/toolbelt

Tutte le issue di codercops/toolbelt

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.