open-index/open-npm huggingface dataset:
npm package: @mantine/carousel
Description: Embla based carousel
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine carousel

[![npm](https://img.shields.io/npm/dm/@mantine/carousel)](https://www.npmjs.com/package/@mantine/carousel)

Embla based carousel

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/core @mantine/hooks @mantine/carousel

# With npm
npm install @mantine/core @mantine/hooks @mantine/carousel
```

## License

MIT
npm package: @mantine/charts
Description: Charts components built with recharts and Mantine
Author: Vitaly Rtishchev
Latest version: 9.0.1

# @mantine/charts

[![npm](https://img.shields.io/npm/dm/@mantine/charts)](https://www.npmjs.com/package/@mantine/charts)

Charts components built with recharts and Mantine

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/charts @mantine/core @mantine/hooks recharts

# With npm
npm install @mantine/charts @mantine/core @mantine/hooks recharts
```

## License

MIT
npm package: @mantine/code-highlight
Description: Code highlight with Mantine theme
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine code highlight

[![npm](https://img.shields.io/npm/dm/@mantine/code-highlight)](https://www.npmjs.com/package/@mantine/code-highlight)

Code highlight built with highlight.js and Mantine

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/hooks @mantine/core @mantine/code-highlight

# With npm
npm install @mantine/hooks @mantine/core @mantine/code-highlight
```

## License

MIT
npm package: @mantine/colors-generator
Description: A library to generate 10 shades of color based on provided color value
Author: Vitaly Rtishchev
Latest version: 9.0.1

# @mantine/colors-generator

[![npm](https://img.shields.io/npm/dm/@mantine/colors-generator)](https://www.npmjs.com/package/@mantine/colors-generator)

Mantine colors generator

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/colors-generator

# With npm
npm install @mantine/colors-generator
```

## License

MIT
npm package: @mantine/core
Description: React components library focused on usability, accessibility and developer experience
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine core

[![npm](https://img.shields.io/npm/dm/@mantine/core)](https://www.npmjs.com/package/@mantine/core)

Mantine core components library.

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/core @mantine/hooks

# With npm
npm install @mantine/core @mantine/hooks
```

## License

MIT
npm package: @mantine/dates
Description: Calendars, date and time pickers based on Mantine components
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine dates

[![npm](https://img.shields.io/npm/dm/@mantine/dates)](https://www.npmjs.com/package/@mantine/dates)

Calendars, date and time pickers

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/core @mantine/hooks @mantine/dates dayjs

# With npm
npm install @mantine/core @mantine/hooks @mantine/dates dayjs
```

## License

MIT
npm package: @mantine/decorations
Description: Decorative svg based components, used mainly as backgrounds and page dividers
Author: Vitaly Rtishchev
Latest version: 3.1.9

# Mantine Decorations

Configurable decorative svg based components, used mainly as backgrounds and page dividers

[View documentation on Mantine website](https://mantine.dev/others/decoration/)

## Installation

Package does not depend on other @mantine/ scoped packages and does not have other dependencies:

```sh
# With yarn
yarn add @mantine/decorations

# With npm
npm install @mantine/decorations
```

## Licence

All Mantine packages have MIT licence.
npm package: @mantine/dropzone
Description: Dropzone component built with Mantine theme and components
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine Dropzone

[![npm](https://img.shields.io/npm/dm/@mantine/dropzone)](https://www.npmjs.com/package/@mantine/dropzone)

Capture files from user

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/dropzone @mantine/core @mantine/hooks

# With npm
npm install @mantine/dropzone @mantine/core @mantine/hooks
```

## License

MIT
npm package: @mantine/ds
Description: Internal Mantine components used on *.mantine.dev websites
Author: Vitaly Rtishchev
Latest version: 6.0.22

# Mantine DS

[![npm](https://img.shields.io/npm/dm/@mantine/ds)](https://www.npmjs.com/package/@mantine/ds)

Mantine logo and other utility components.

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/core @mantine/hooks @mantine/prism @mantine/ds

# With npm
npm install @mantine/core @mantine/hooks @mantine/prism @mantine/ds
```

## License

MIT
npm package: @mantine/emotion
Description: Emotion bindings for Mantine
Author: Vitaly Rtishchev
Latest version: 9.0.1

# @mantine/emotion

[![npm](https://img.shields.io/npm/dm/@mantine/emotion)](https://www.npmjs.com/package/@mantine/emotion)

Emotion bindings for @mantine/core

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/emotion @mantine/core @mantine/hooks @emotion/react

# With npm
npm install @mantine/emotion @mantine/core @mantine/hooks @emotion/react
```

## License

MIT
npm package: @mantine/form
Description: Mantine form management library
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine Form

[![npm](https://img.shields.io/npm/dm/@mantine/form)](https://www.npmjs.com/package/@mantine/form)

Form management library

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/form

# With npm
npm install @mantine/form
```

## License

MIT
npm package: @mantine/hooks
Description: A collection of 50+ hooks for state and UI management
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine Hooks

[![npm](https://img.shields.io/npm/dm/@mantine/hooks)](https://www.npmjs.com/package/@mantine/hooks)

A set of react hooks for state and UI management

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/hooks

# With npm
npm install @mantine/hooks
```

## License

MIT
npm package: @mantine/labs
Description: Experimental unstable Mantine components
Author: Vitaly Rtishchev
Latest version: 5.10.5

# Mantine Labs

Experimental Mantine components, use at your own risk

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/hooks @mantine/core @mantine/labs

# With npm
npm install @mantine/hooks @mantine/core @mantine/labs
```

## License

MIT
npm package: @mantine/mcp-server
Description: MCP server for Mantine documentation
Author: Vitaly Rtishchev
Latest version: 9.0.1

# @mantine/mcp-server

MCP server for Mantine documentation.

## Usage

```bash
npx @mantine/mcp-server
```

## Configuration

- `MANTINE_MCP_DATA_URL` – static MCP data base URL (`https://mantine.dev/mcp` by default)
- `MANTINE_MCP_TIMEOUT_MS` – HTTP timeout in milliseconds (`10000` by default)

## Tools

- `list_items`
- `get_item_doc`
- `get_item_props`
- `search_docs`
npm package: @mantine/modals
Description: Modals manager based on Mantine components
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine modals manager

[![npm](https://img.shields.io/npm/dm/@mantine/modals)](https://www.npmjs.com/package/@mantine/modals)

Manage modals state

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/hooks @mantine/core @mantine/modals

# With npm
npm install @mantine/hooks @mantine/core @mantine/modals
```

## License

MIT
npm package: @mantine/next
Description: Mantine integration for Next.js
Author: Vitaly Rtishchev
Latest version: 6.0.22

# Mantine integration for Next.js

[![npm](https://img.shields.io/npm/dm/@mantine/next)](https://www.npmjs.com/package/@mantine/next)

Utilities to setup Mantine server side rendering with Next.js

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/hooks @mantine/core @mantine/next

# With npm
npm install @mantine/hooks @mantine/core @mantine/next
```

## License

MIT
npm package: @mantine/notifications
Description: Mantine notifications system
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine notifications system

[![npm](https://img.shields.io/npm/dm/@mantine/notifications)](https://www.npmjs.com/package/@mantine/notifications)

Notifications system

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/hooks @mantine/core @mantine/notifications

# With npm
npm install @mantine/hooks @mantine/core @mantine/notifications
```

## License

MIT
npm package: @mantine/nprogress
Description: Navigation progress bar
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine Navigation Progress

[![npm](https://img.shields.io/npm/dm/@mantine/nprogress)](https://www.npmjs.com/package/@mantine/nprogress)

A navigation progress bar

[Documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/nprogress @mantine/core @mantine/hooks

# With npm
npm install @mantine/nprogress @mantine/core @mantine/hooks
```

## License

MIT
npm package: @mantine/prism
Description: Code highlight with Mantine theme
Author: Vitaly Rtishchev
Latest version: 6.0.22

# Mantine prism code highlight

[![npm](https://img.shields.io/npm/dm/@mantine/prism)](https://www.npmjs.com/package/@mantine/prism)

Code highlight built with prism and Mantine

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/hooks @mantine/core @mantine/prism

# With npm
npm install @mantine/hooks @mantine/core @mantine/prism
```

## License

MIT
npm package: @mantine/remix
Description: Mantine integration for Remix
Author: Vitaly Rtishchev
Latest version: 6.0.22

# Mantine integration for Remix

[![npm](https://img.shields.io/npm/dm/@mantine/remix)](https://www.npmjs.com/package/@mantine/remix)

Utilities to setup Mantine server side rendering with Remix

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/hooks @mantine/core @mantine/remix

# With npm
npm install @mantine/hooks @mantine/core @mantine/remix
```

## License

MIT
npm package: @mantine/rte
Description: Rich text editor built with Mantine components
Author: Vitaly Rtishchev
Latest version: 5.10.5

# Mantine rich text editor

[![npm](https://img.shields.io/npm/dm/@mantine/rte)](https://www.npmjs.com/package/@mantine/rte)

Quill based rich text editor

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/hooks @mantine/core @mantine/rte

# With npm
npm install @mantine/hooks @mantine/core @mantine/rte
```

## License

MIT
npm package: @mantine/schedule
Description: Schedule Mantine component
Author: Vitaly Rtishchev
Latest version: 9.0.1

# @mantine/schedule

[![npm](https://img.shields.io/npm/dm/@mantine/schedule)](https://www.npmjs.com/package/@mantine/schedule)

Schedule Mantine component

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/schedule @mantine/core @mantine/hooks @mantine/dates

# With npm
npm install @mantine/schedule @mantine/core @mantine/hooks @mantine/dates
```

## License

MIT
npm package: @mantine/spotlight
Description: Command center components for react and Mantine
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine Spotlight

[![npm](https://img.shields.io/npm/dm/@mantine/spotlight)](https://www.npmjs.com/package/@mantine/spotlight)

Overlay command center for your application

[Documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/spotlight @mantine/core @mantine/hooks

# With npm
npm install @mantine/spotlight @mantine/core @mantine/hooks
```

## License

MIT
npm package: @mantine/ssr
Description: Mantine server side rendering utils
Author: Vitaly Rtishchev
Latest version: 6.0.22

# Mantine SSR

[![npm](https://img.shields.io/npm/dm/@mantine/ssr)](https://www.npmjs.com/package/@mantine/ssr)

General purpose utilities for Mantine server side rendering

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/hooks @mantine/core @mantine/ssr

# With npm
npm install @mantine/hooks @mantine/core @mantine/ssr
```

## License

MIT
npm package: @mantine/store
Description: A library to sync external React state updates
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine Store

[![npm](https://img.shields.io/npm/dm/@mantine/store)](https://www.npmjs.com/package/@mantine/store)

Global state manager for `@mantine/notifications`, `@mantine/nprogress`, `@mantine/spotlight` and other Mantine packages.

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/store

# With npm
npm install @mantine/store
```

## License

MIT
npm package: @mantine/styles
Description: Mantine css-in-js styles engine, based on emotion
Author: Vitaly Rtishchev
Latest version: 6.0.22

# Mantine styles

[![npm](https://img.shields.io/npm/dm/@mantine/styles)](https://www.npmjs.com/package/@mantine/styles)

Mantine CSS-in-JS library built on top of emotion

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/styles

# With npm
npm install @mantine/styles
```

## License

MIT
npm package: @mantine/tag-picker
Description: Notion style tag picker built with Mantine
Author: Vitaly Rtishchev
Latest version: 2.1.5

# Mantine Tag Picker

![Demo](https://github.com/mantinedev/mantine/blob/master/.demo/tag-picker.gif)

Notion like tag picker component built on top of [Mantine](https://mantine.dev/) components library.

[Documentation](https://mantine.dev/others/tag-picker/)

## Installation

```sh
# With yarn
yarn add @mantine/tag-picker @mantine/core @mantine/hooks react-jss

# With npm
yarn add @mantine/tag-picker @mantine/core @mantine/hooks react-jss

# With install-peerdeps
npx install-peerdeps @mantine/tag-picker
```

## Licence

All Mantine packages have MIT licence. All Mantine dependencies also have MIT licence, except react-transition-group package which has BSD-3-Clause license.
npm package: @mantine/tiptap
Description: Rich text editor based on tiptap
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine tiptap

[![npm](https://img.shields.io/npm/dm/@mantine/tiptap)](https://www.npmjs.com/package/@mantine/tiptap)

Rich text editor based on [tiptap](https://tiptap.dev/)

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/tiptap @mantine/core @mantine/hooks @tiptap/react @tiptap/extension-link

# With npm
npm install @mantine/tiptap @mantine/core @mantine/hooks @tiptap/react @tiptap/extension-link
```

## License

MIT
npm package: @mantine/utils
Description: [![npm](https://img.shields.io/npm/dm/@mantine/utils)](https://www.npmjs.com/package/@mantine/utils)
Author: Vitaly Rtishchev
Latest version: 6.0.22

# Mantine Hooks

[![npm](https://img.shields.io/npm/dm/@mantine/utils)](https://www.npmjs.com/package/@mantine/utils)

A set of utils used in Mantine packages

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/utils

# With npm
npm install @mantine/utils
```

## License

MIT
npm package: @mantine/vanilla-extract
Description: Vanilla Extract integration for Mantine theme
Author: Vitaly Rtishchev
Latest version: 9.0.1

# Mantine Vanilla Extract

[![npm](https://img.shields.io/npm/dm/@mantine/vanilla-extract)](https://www.npmjs.com/package/@mantine/vanilla-extract)

Mantine theme integration with vanilla-extract

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantine/vanilla-extract

# With npm
npm install @mantine/vanilla-extract
```

## License

MIT
npm package: @mantinex/demo
Description: Demo base components used on *.mantine.dev websites
Author: Vitaly Rtishchev
Latest version: 2.0.0

# @mantinex/demo

[![npm](https://img.shields.io/npm/dm/@mantinex/demo)](https://www.npmjs.com/package/@mantinex/demo)

Demo base components used on *.mantine.dev websites

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantinex/demo

# With npm
npm install @mantinex/demo
```

## License

MIT
npm package: @mantinex/dev-icons
Description: Dev icons used on *.mantine.dev websites
Author: Vitaly Rtishchev
Latest version: 2.0.0

# @mantinex/dev-icons

[![npm](https://img.shields.io/npm/dm/@mantinex/dev-icons)](https://www.npmjs.com/package/@mantinex/dev-icons)

Dev icons used on *.mantine.dev websites

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantinex/dev-icons

# With npm
npm install @mantinex/dev-icons
```

## License

MIT
npm package: @mantinex/mantine-header
Description: Components used in headers of *.mantine.dev websites
Author: Vitaly Rtishchev
Latest version: 2.0.0

# @mantinex/mantine-header

[![npm](https://img.shields.io/npm/dm/@mantinex/mantine-header)](https://www.npmjs.com/package/@mantinex/mantine-header)

Components used in headers of *.mantine.dev websites

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantinex/mantine-header

# With npm
npm install @mantinex/mantine-header
```

## License

MIT
npm package: @mantinex/mantine-logo
Description: Mantine logo as react component
Author: Vitaly Rtishchev
Latest version: 2.0.0

# @mantinex/mantine-logo

[![npm](https://img.shields.io/npm/dm/@mantinex/mantine-logo)](https://www.npmjs.com/package/@mantinex/mantine-logo)

Mantine logo as react component

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantinex/mantine-logo

# With npm
npm install @mantinex/mantine-logo
```

Then import styles:

```tsx
import '@mantinex/mantine-logo/styles.css';
```

## License

MIT
npm package: @mantinex/mantine-meta
Description: Meta data for *.mantine.dev websites
Author: Vitaly Rtishchev
Latest version: 2.0.0

# @mantinex/mantine-meta

[![npm](https://img.shields.io/npm/dm/@mantinex/mantine-meta)](https://www.npmjs.com/package/@mantinex/mantine-meta)

Meta data for *.mantine.dev websites

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantinex/mantine-meta

# With npm
npm install @mantinex/mantine-meta
```

## License

MIT
npm package: @mantinex/shiki
Description: Code highlighing with shiki
Author: Vitaly Rtishchev
Latest version: 1.1.0

# @mantinex/shiki

[![npm](https://img.shields.io/npm/dm/@mantinex/shiki)](https://www.npmjs.com/package/@mantinex/shiki)

Code highlighing with shiki

[View documentation](https://mantine.dev/)

## Installation

```bash
# With yarn
yarn add @mantinex/shiki

# With npm
npm install @mantinex/shiki
```

## License

MIT
npm package: @mantiq/auth
Description: Session & token auth, guards, providers
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/auth

Session & token authentication, guards, providers, and middleware for MantiqJS.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/auth
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/cli
Description: Command runner, code generators, dev server
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/cli

Command kernel, code generators, database commands, REPL, and route listing for MantiqJS.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/cli
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/core
Description: Service container, router, middleware, HTTP kernel, config, and exception handler
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/core

The foundation of MantiqJS — service container, router, middleware, HTTP kernel, config, encryption, hashing, caching, and sessions.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/core
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/database
Description: Query builder, ORM, migrations, seeders, factories — with SQLite, Postgres, MySQL and MongoDB support
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/database

Query builder, Eloquent-style ORM, schema migrations, seeders, and factories for MantiqJS. Supports SQLite, Postgres, MySQL, and MongoDB.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/database
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/events
Description: Event dispatcher, listeners, observers, and broadcasting for MantiqJS
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/events

Event dispatcher, broadcasting, and model observers for MantiqJS.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/events
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/filesystem
Description: Filesystem abstraction — local, S3, GCS, R2, Azure, FTP, SFTP drivers with uniform API
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/filesystem

Filesystem abstraction for MantiqJS — Local, S3, GCS, Azure Blob, FTP, and SFTP drivers.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/filesystem
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/heartbeat
Description: Observability, APM & queue monitoring for MantiqJS
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/heartbeat

Observability, APM, and request/query/exception tracing for MantiqJS. Self-contained dashboard at `/_heartbeat`.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/heartbeat
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/helpers
Description: Str, Arr, Num, Collection utilities
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/helpers

Utility library for MantiqJS — Str, Arr, Num, Collection, HTTP client, and async utilities.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/helpers
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/logging
Description: Channel-based logging
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/logging

Channel-based logging for MantiqJS — console, file, daily rotation, and stack drivers.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/logging
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/mail
Description: Transactional email — SMTP, Resend, SendGrid, Mailgun, Postmark, SES, markdown templates
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/mail

Email sending for MantiqJS (coming soon).

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/mail
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/notify
Description: Multi-channel notifications — mail, database, broadcast, SMS, Slack, webhook
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/notify

Multi-channel notifications for [MantiqJS](https://github.com/mantiqjs/mantiq).

Built-in channels: mail, database, broadcast, SMS, Slack, webhook. Extensible — any package can register custom channels.

```bash
bun add @mantiq/notify
```
npm package: @mantiq/queue
Description: Job dispatching, workers, retry logic
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/queue

Job dispatching, chains, batches, and scheduling for MantiqJS — sync, SQLite, Redis, SQS, and Kafka drivers.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/queue
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/realtime
Description: WebSocket, SSE, channels, broadcasting
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/realtime

WebSocket server, SSE, and channel system for MantiqJS — public, private, and presence channels.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/realtime
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/validation
Description: Rule engine, form requests
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/validation

Validation rule engine with 40+ built-in rules and FormRequest base class for MantiqJS.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/validation
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantiq/vite
Description: Vite dev server & manifest integration
Author: Abdullah Khan
Latest version: 0.7.18

# @mantiq/vite

Vite dev server integration, SSR support, and static file serving for MantiqJS.

Part of [MantiqJS](https://github.com/mantiqjs/mantiq) — a batteries-included TypeScript web framework for Bun.

## Installation

```bash
bun add @mantiq/vite
```

## Documentation

See the [MantiqJS repository](https://github.com/mantiqjs/mantiq) for full documentation.

## License

MIT
npm package: @mantis-core/commons
Description: Shared contracts and common primitives for Mantis Core packages.
Latest version: 0.1.3

# @mantis-core/commons

Shared contracts and primitive types used by other `@mantis-core/*` packages and app adapters.

## Scope

- Generic action/result contracts.
- Shared pagination contract.
- Zero runtime side effects.

## Out Of Scope

- Domain entities (house/lead/blog/etc).
- UI components.
- App-specific API shapes.

## Public API

```ts
export type ResultWrapper<T> = { data: T | null; error: string | null };

export type ActionResult<T> = Promise<ResultWrapper<T>>;

export type Paginated<T> = {
  data: T[];
  pagination: {
    page: number;
    pageSize: number;
    totalCount: number;
    totalPages: number;
    hasNextPage: boolean;
    hasPreviousPage: boolean;
  };
};
```

## Usage Example

```ts
import type { ActionResult, Paginated } from "@mantis-core/commons";

type Item = { id: string; name: string };

export async function getItems(): ActionResult<Paginated<Item>> {
  return {
    data: {
      data: [{ id: "1", name: "Example" }],
      pagination: {
        page: 1,
        pageSize: 10,
        totalCount: 1,
        totalPages: 1,
        hasNextPage: false,
        hasPreviousPage: false,
      },
    },
    error: null,
  };
}
```

## Build

```bash
pnpm --filter @mantis-core/commons build
pnpm --filter @mantis-core/commons typecheck
```

## Notes

- Keep API minimal and stable.
- Prefer additive changes for backward compatibility.
npm package: @mantis-core/next-core
Description: Reusable Next.js providers and app-level runtime setup for Mantis Core.
Latest version: 0.1.3

# @mantis-core/next-core

Reusable Next.js app-level providers for Mantis Core apps.

## Scope

- Query client creation.
- Session provider wiring.
- PrimeReact provider wiring.
- Toast provider wiring.

## Out Of Scope

- Route/page business logic.
- Domain data fetching.
- UI components outside provider concerns.

## Public API

```ts
createMantisCoreQueryClient(): QueryClient

type MantisCoreBaseProviderProps = PropsWithChildren<{
  includeSessionProvider?: boolean;
  includeToaster?: boolean;
  queryClient?: QueryClient;
  toasterProps?: ToasterProps;
}>;

MantisCoreBaseProvider(props)

type UseMantisToasts = {
  addSuccessToast(...)
  addErrorToast(...)
  addInfoToast(...)
  addWarningToast(...)
  addLoadingToast(...)
  promiseToast(...)
  jsxToast(...)
  dismiss(...)
  remove(...)
}

useMantisToasts(): UseMantisToasts
```

## Usage Example

```tsx
"use client";

import { MantisCoreBaseProvider } from "@mantis-core/next-core";

export default function Providers({ children }: { children: React.ReactNode }) {
  return <MantisCoreBaseProvider>{children}</MantisCoreBaseProvider>;
}
```

```tsx
"use client";

import { useMantisToasts } from "@mantis-core/next-core";

export function Example() {
  const toast = useMantisToasts();
  return <button onClick={() => toast.addSuccessToast("Guardado")}>Toast</button>;
}
```

## Provider Behavior

- Creates a default `QueryClient` unless one is injected.
- Wraps children with `PrimeReactProvider`.
- Optionally includes `SessionProvider`.
- Optionally includes `react-hot-toast` with sane defaults.
- Toast defaults use CSS tokens (`--card`, `--foreground`, `--border`, semantic colors).

## Build

```bash
pnpm --filter @mantis-core/next-core build
pnpm --filter @mantis-core/next-core typecheck
```

## Peer Dependencies

This package expects the consuming app to provide:

- `react`, `react-dom`
- `next-auth`
- `@tanstack/react-query`
- `primereact`
- `react-hot-toast`
npm package: @mantis-core/nuqs
Description: Shared nuqs parsers and URL-state helpers for Mantis Core.
Latest version: 0.1.3

# @mantis-core/nuqs

Reusable parsers/helpers for URL state management with `nuqs`.

## Scope

- Parser factories that can be shared across apps.
- Serialization/deserialization consistency via `superjson`.

## Out Of Scope

- Route-specific query contracts.
- Domain-specific URL semantics.

## Public API

```ts
parseAsSuperJson
parseAsStringArray
createParseAsEnumArray<T extends string>(allowedValues: readonly T[])
```

## Usage Example

```ts
import { parseAsStringArray, createParseAsEnumArray } from "@mantis-core/nuqs";

const parseStatusArray = createParseAsEnumArray(["draft", "published"] as const);

const tags = parseAsStringArray.parse('["house","blog"]');
const statuses = parseStatusArray.parse('["draft","invalid"]');
// statuses -> ["draft"]
```

## Build

```bash
pnpm --filter @mantis-core/nuqs build
pnpm --filter @mantis-core/nuqs typecheck
```
npm package: @mantis-core/styles
Description: Shared SCSS tokens and Mantis Core style overrides.
Latest version: 0.1.3

# @mantis-core/styles

Shared raw SCSS modules and style contracts for Mantis Core packages.

## Purpose

`@mantis-core/styles` ships reusable SCSS partials that style PrimeReact controls, `react-select`, CKEditor content, and Mantis-specific `mantis-core-*` class contracts.

## Scope

- Shared visual contracts used by `@mantis-core/ui`
- PrimeReact-oriented overrides
- SCSS partials that assume shared design tokens such as `--primary`, `--border`, and `--card`

## Out of Scope

- App-specific branding rules outside token values
- Runtime style injection
- React components

## Export Model

- `@mantis-core/styles` -> `scss/index.scss`
- `@mantis-core/styles/scss/*` -> direct raw SCSS partials

The package ships raw SCSS. Consumers are expected to import the partials they need from their app stylesheet pipeline.

## Usage

Import everything:

```scss
@use "@mantis-core/styles";
```

Import selectively:

```scss
@use "@mantis-core/styles/scss/buttons.scss";
@use "@mantis-core/styles/scss/inputs.scss";
@use "@mantis-core/styles/scss/table.scss";
```

## Documentation Index

- [docs/README.md](./docs/README.md): package documentation index
- [STYLES.md](./STYLES.md): lightweight partial index
- [STYLE_CONTRACTS.md](./STYLE_CONTRACTS.md): lightweight style-contract pointer

## Important Notes

1. This package does not define the global tokens themselves. It expects them to exist in the consuming app.
2. Some partials style third-party markup directly, such as PrimeReact selectors or `react-select` class names.
3. Some partials expose first-class `mantis-core-*` contracts that are intended to be stable across apps.

## Local Validation

```bash
pnpm --filter @mantis-core/styles build
```
npm package: @mantis-core/supabase-core
Description: Reusable Supabase infrastructure for Mantis Core apps.
Latest version: 0.1.3

# @mantis-core/supabase-core

Reusable Supabase infrastructure for Mantis Core applications.

## Scope

- Env resolution/validation for Supabase.
- Browser and server Supabase client factories.
- Standard action execution contract (`runAction`).
- Storage helper utilities.
- Generic search/pagination helpers.

## Out Of Scope

- Domain repositories and domain actions.
- Client-specific migrations/RLS policies.
- Domain schema ownership.

## Public API Modules

- `@mantis-core/supabase-core/action-utils`
- `@mantis-core/supabase-core/env`
- `@mantis-core/supabase-core/client`
- `@mantis-core/supabase-core/server`
- `@mantis-core/supabase-core/storage`
- `@mantis-core/supabase-core/utils/search`
- `@mantis-core/supabase-core/utils/pagination`

## Key Functions

```ts
runAction<T>(fn, options?) -> Promise<{ data: T | null; error: string | null }>
resolveSupabaseEnv(options?) -> ResolvedSupabaseEnv
createMantisCoreBrowserClient<Database>(url, key)
createMantisCoreServerClient<Database>(options)
createMantisCoreRouteHandlerClient<Database>(options)
sanitizeStorageFileName(name)
createTimestampedStorageFileName(name)
createStorageObjectPath(fileName, parentPath?)
getPublicStorageUrl(supabaseUrl, bucket, filePath)
```

## Recommended App Flow

1. UI/feature layer
2. Domain hook (client reads)
3. Server action (`runAction` contract)
4. Domain repository
5. Supabase

This package provides layer 4.5 infrastructure, not domain logic.

## Usage Example

```ts
import { runAction } from "@mantis-core/supabase-core/action-utils";
import { createMantisCoreServerClient } from "@mantis-core/supabase-core/server";

export async function safeMutation() {
  return runAction(async () => {
    const supabase = createMantisCoreServerClient({
      supabaseUrl: process.env.NEXT_PUBLIC_SUPABASE_URL!,
      supabaseAnonKey: process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
      cookieStore: {
        getAll: () => [],
        set: () => undefined,
      },
    });

    const { data, error } = await supabase.from("table").select("*");
    if (error) throw error;
    return data;
  });
}
```

## Build

```bash
pnpm --filter @mantis-core/supabase-core build
pnpm --filter @mantis-core/supabase-core typecheck
```

## Peer Dependencies

- `next` (cookie/runtime integration)
- Supabase packages are standard dependencies in this package.
npm package: @mantis-core/utils
Description: Reusable framework-agnostic utility helpers for Mantis Core.
Latest version: 0.4.0

# @mantis-core/utils

Scalable utility toolkit for Mantis Core with runtime-specific modules.

See architecture governance in [`ARCHITECTURE.md`](./ARCHITECTURE.md).

## Scope

- Shared reusable helpers for all Mantis Core apps/packages.
- Strong TypeScript contracts (`Result`, branded types, generic helpers).
- Runtime-separated APIs for safer imports:
  - isomorphic (`@mantis-core/utils`)
  - browser-only (`@mantis-core/utils/browser`)
  - node-only (`@mantis-core/utils/node`)

## Out Of Scope

- Domain/business logic (real estate, leads, blog workflows).
- Supabase repositories/actions.
- Next.js route-specific behavior.

## Folder Architecture

```txt
src/
  index.ts              # isomorphic public API
  types.ts              # shared advanced types
  isomorphic/
    index.ts
    classnames.ts
    select.ts
    date.ts
    currency.ts
    base64.ts
    sanitize-html.ts
  browser/
    index.ts
    device.ts
    events.ts
  node/
    index.ts
    crypto.ts
```

## Public API

### 1) Isomorphic (`@mantis-core/utils`)

- `cn(...inputs)`
- `getFilterValue(...)`
- `toStartOfDayIso(...)`
- `toEndOfDayIso(...)`
- `getPaginationRange(...)`
- `formatCurrency(...)`
- `encodeBase64Json(...)`
- `decodeBase64Json(...)`
- `decodeBase64JsonOrThrow(...)`
- `sanitizeHtmlContent(...)`
- types: `Brand`, `Result`, `JsonValue`, `MaybeArray`, `ValueOf`

### 2) Browser (`@mantis-core/utils/browser`)

- `isIOSDevice(...)`
- `isInStandaloneMode(...)`
- `isPwaInIOS(...)`
- `createClickIntentHandler(...)`
- `simulateTouch(...)`
- `setViewportHeightCssVar(...)`

### 3) Node (`@mantis-core/utils/node`)

- `hashString(...)`
- `toSha512(...)`, `toSha256(...)`, `toSha1(...)`, `toMd5(...)`
- `generateRandomString(...)`
- `isAes256KeyHex(...)`
- `assertAes256KeyHex(...)`
- `encryptAes256Cbc(...)`
- `decryptAes256Cbc(...)`
- types: `HexDigest`, `Aes256KeyHex`

## Import Rules

- Use root import for cross-runtime helpers:
  - `import { formatCurrency } from "@mantis-core/utils";`
- Use explicit runtime subpaths for platform APIs:
  - `import { toSha512 } from "@mantis-core/utils/node";`
  - `import { isPwaInIOS } from "@mantis-core/utils/browser";`

Do not import node helpers in client bundles.

## Build

```bash
pnpm --filter @mantis-core/utils build
pnpm --filter @mantis-core/utils typecheck
```

## Scalability Rules

1. Place a utility by runtime first:
   - `src/isomorphic/*`: can execute in browser and Node.
   - `src/browser/*`: requires `window`, `document`, `navigator`, `Touch*`.
   - `src/node/*`: requires Node built-ins (`node:*`, `Buffer`, filesystem/crypto APIs).
2. Keep functions single-purpose and side-effect free when possible.
3. Prefer explicit return contracts (`Result`, branded types, discriminated unions) over thrown errors for recoverable failures.
4. Do not add domain/business vocabulary (houses, leads, blog workflows).
5. Any new utility must include:
   - named export from its runtime `index.ts`
   - README usage update if it is part of public API
   - package build/typecheck passing