Skip to content

Add comprehensive README with API docs, examples, and philosophy#1

Open
matthewhudson wants to merge 1 commit intoava:mainfrom
matthewhudson:chore/readme
Open

Add comprehensive README with API docs, examples, and philosophy#1
matthewhudson wants to merge 1 commit intoava:mainfrom
matthewhudson:chore/readme

Conversation

@matthewhudson
Copy link

Replaces the image-only README with comprehensive documentation so developers can understand and use the library without leaving GitHub.

Changes:

  • One-liner pitch and hero code snippet showing the verb(noun) + noun.state pattern
  • Before/after comparison (useState vs useToggles)
  • Install instructions (yarn/npm)
  • Quick start example
  • Full API reference for useToggles, useToggle, all 15 verb pairs, and noun states
  • Verb/state lookup table
  • Usage examples: modal, settings panel, global namespaces, useEffect
  • Compatibility notes (React 16.9+, SSR, TypeScript, bundle size)
  • Philosophy section linking back to the https://alexcory.notion.site/toggles

Replace the image-only README with full documentation covering
install, quick start, API reference, verb/state tables, usage
examples (modal, settings, namespaces, useEffect), and the
library's natural-language design philosophy.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant