# Mongez

> A TypeScript ecosystem for full-stack apps: atom-shaped state, client-side server-data caching, event bus, utility belt. Framework-agnostic core with React adapters. Built for AI-assisted development.

## Packages

- [@mongez/atom](https://mongez.js.org/atom/llms.txt): framework-agnostic atomic state primitive with action methods, derived values, persistence, SSR stores, Redux DevTools.
- [@mongez/react-atom](https://mongez.js.org/react-atom/llms.txt): React adapter for @mongez/atom — hooks on every atom, `<AtomStoreProvider>` for SSR scoping, preset atoms, hydration helpers.
- [@mongez/atomic-query](https://mongez.js.org/atomic-query/llms.txt): client-side query cache. `useQuery`, `useMutation`, `useInfiniteQuery`, `useSuspenseQuery`. Segment-aware invalidation.
- [@mongez/events](https://mongez.js.org/events/llms.txt): tiny event bus with segment-aware namespace matching.
- [@mongez/reinforcements](https://mongez.js.org/reinforcements/llms.txt): TypeScript utility belt — ~130 functions for objects, strings, numbers, async, randomness.

## Full reference

- [llms-full.txt](https://mongez.js.org/llms-full.txt): every package's full reference concatenated into one file. One fetch wins when you want everything.
- Per-package full references: [/atom/llms-full.txt](https://mongez.js.org/atom/llms-full.txt) · [/react-atom/llms-full.txt](https://mongez.js.org/react-atom/llms-full.txt) · [/atomic-query/llms-full.txt](https://mongez.js.org/atomic-query/llms-full.txt) · [/events/llms-full.txt](https://mongez.js.org/events/llms-full.txt) · [/reinforcements/llms-full.txt](https://mongez.js.org/reinforcements/llms-full.txt)

## Docs

- [mongez.js.org](https://mongez.js.org): human-readable docs site.
- [GitHub](https://github.com/hassanzohdy): source code per package.

## Quick rules across the family

1. **Atoms with action methods** — define domain verbs on the atom; call them as `cart.push(item)`, `modal.open()`, `auth.login()`.
2. **One mental model for ephemeral and server state** — `@mongez/react-atom` for UI flags, `@mongez/atomic-query` for server data. Same atom shape, same hooks, same DX.
3. **SSR is the framework's job** — Next.js server components, Remix `loader`, TanStack Start `loader`. The libraries hand off via `<HydrateAtomsScript>` / `<HydrateQueries>`.
4. **React 18+** for `@mongez/react-atom` and `@mongez/atomic-query`. The core `@mongez/atom` works in any framework or vanilla TypeScript.
5. **AI-first documentation** — every package has `llms.txt`, `llms-full.txt`, and a `skills/` folder of dense reference cards designed for LLM ingestion.