coreinch/namernut

How coreinch/namernut works

Namernut generates business-name candidates from a dictionary and optional AI or spelling variants, checks domains and social handles, filters name quality, and can score real-world brand competition. The principal flow runs from the browser through the discovery API and discovery engine, then streams findings back to saved results and controls. The graph also preserves the documented favorites/archive and brandability capabilities. Relationships for unsampled integrations are included only where the README or source index supports them; some internal availability-check details are not excerpted.

Main entry points: route.ts Discovery endpoint · page.tsx App workspace · useDiscoveryRun.ts Run controller · discovery.ts Discovery engine

Components 28

User experience

App workspace src/app/page.tsx
Search controls src/components/SearchBar.tsx
Search settings src/components/SettingsPanel.tsx
Run controller src/hooks/useDiscoveryRun.ts
Name result card src/components/ResultCard.tsx

Name generation

Discovery endpoint src/app/api/discover/route.ts
Word dictionary src/lib/dictionary.ts
Candidate builder src/lib/candidates.ts
AI name variants src/lib/suggestNames.ts
Synonym suggestions src/lib/synonyms.ts
Invented names src/lib/inventedNames.ts
Alternate spellings src/lib/alternateSpelling.ts
Discovery engine src/lib/discovery.ts
Name quality filters src/lib/discovery.ts

Availability checks

Availability checks src/lib/discoveryChecks.ts
Social handle checks src/lib/socialStatus.ts
Domain and platform services src/lib/rdap.ts

Brandability analysis

Brandability endpoint src/app/api/brandability/route.ts
Competition scoring src/lib/brandability.ts
Search fallback src/lib/searchProvider.ts
Serper search src/lib/serperSearch.ts
2captcha search src/lib/twocaptchaSearch.ts
Serpent search src/lib/serpentSearch.ts
LLM service src/lib/kilocode.ts

Results and state

Local state src/hooks/usePersistedAppState.ts
Result lists src/hooks/useResultLists.ts
Favorites and archive src/hooks/usePersistedAppState.ts

Other components

Name seeker

Connections 30

Name seeker → App workspace: uses src/app/page.tsx
App workspace → Search controls: renders src/app/page.tsx
App workspace → Search settings: renders src/app/page.tsx
App workspace → Run controller: starts runs src/app/page.tsx
App workspace → Local state: loads state src/app/page.tsx
Run controller → Discovery endpoint: requests stream
Discovery endpoint → Word dictionary: loads words src/app/api/discover/route.ts
Discovery endpoint → AI name variants: requests variants src/app/api/discover/route.ts
Discovery endpoint → Synonym suggestions: requests synonyms src/app/api/discover/route.ts
Discovery endpoint → Invented names: requests names src/app/api/discover/route.ts
Discovery endpoint → Alternate spellings: uses variants src/app/api/discover/route.ts
Discovery endpoint → Discovery engine: runs discovery src/app/api/discover/route.ts
Discovery engine → Candidate builder: builds space src/lib/discovery.ts
Candidate builder → Word dictionary: uses word pool src/lib/candidates.ts
Discovery engine → Name quality filters: filters candidates src/lib/discovery.ts
Discovery engine → Availability checks: checks domains src/lib/discovery.ts
Availability checks → Social handle checks: checks handles
Availability checks → Domain and platform services: checks domains
Run controller → Brandability endpoint: checks found names
Brandability endpoint → Competition scoring: scores names src/app/api/brandability/route.ts
Competition scoring → Search fallback: searches competition src/lib/brandability.ts
Search fallback → Serper search: dispatches search src/lib/searchProvider.ts
Search fallback → 2captcha search: dispatches fallback src/lib/searchProvider.ts
Search fallback → Serpent search: dispatches fallback src/lib/searchProvider.ts
Competition scoring → LLM service: generates summary src/lib/brandability.ts
Run controller → Local state: updates results src/hooks/useDiscoveryRun.ts
App workspace → Result lists: shows lists src/app/page.tsx
Result lists → Name result card: renders entries
Name result card → Favorites and archive: supports actions
Local state → Favorites and archive: stores locally src/hooks/usePersistedAppState.ts

More TypeScript diagrams: m-cheng-web/web-tracing · tajo/ladle · devdotfast/whiteboard · intellectronica/ruler · chattocorp/chatto

Drawn by GitDiagram on October 1, 2026 from the repository's file tree, README and source files. Read as Markdown ·