{"_id":"@boiboif/react-native-toast","name":"@boiboif/react-native-toast","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@boiboif/react-native-toast","version":"0.1.0","description":"A customizable native toast library for React Native New Architecture","main":"./lib/module/index.js","types":"./lib/typescript/src/index.d.ts","exports":{".":{"boiboif-react-native-toast-source":"./src/index.ts","types":"./lib/typescript/src/index.d.ts","default":"./lib/module/index.js"},"./package.json":"./package.json"},"scripts":{"example":"yarn workspace @boiboif/react-native-toast-example","clean":"del-cli android/build example/android/build example/android/app/build example/ios/build lib","docs:dev":"vitepress dev docs --host 0.0.0.0","docs:build":"vitepress build docs","docs:preview":"vitepress preview docs --host 0.0.0.0","prepare":"bob build","release":"npm publish --access public --registry=https://registry.npmjs.org/","typecheck":"tsc","lint":"eslint \"**/*.{js,ts,tsx}\""},"keywords":["react-native","toast","turbo-module","new-architecture","ios","android"],"repository":{"type":"git","url":"git+https://github.com/boiboif/react-native-toast.git"},"author":{"name":"boiboif","email":"boiboif@users.noreply.github.com","url":"https://github.com/boiboif"},"license":"MIT","bugs":{"url":"https://github.com/boiboif/react-native-toast/issues"},"homepage":"https://boiboif.github.io/react-native-toast/","sideEffects":false,"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"devDependencies":{"@eslint/compat":"^2.1.0","@eslint/eslintrc":"^3.3.5","@eslint/js":"^10.0.1","@react-native/babel-preset":"0.85.0","@react-native/eslint-config":"0.85.0","@types/react":"^19.2.0","del-cli":"^7.0.0","eslint":"^9.39.4","eslint-config-prettier":"^10.1.8","eslint-plugin-ft-flow":"^3.0.11","eslint-plugin-prettier":"^5.5.6","prettier":"^3.8.3","react":"19.2.3","react-native":"0.85.0","react-native-builder-bob":"^0.41.0","turbo":"^2.9.16","typescript":"^6.0.3","vitepress":"^1.6.4"},"peerDependencies":{"react":">=18.2.0","react-native":">=0.76.0"},"workspaces":["example"],"packageManager":"yarn@4.11.0","react-native-builder-bob":{"source":"src","output":"lib","targets":[["module",{"esm":true}],["typescript",{"project":"tsconfig.build.json"}]]},"codegenConfig":{"name":"ReactNativeToastSpec","type":"modules","jsSrcsDir":"src/specs","android":{"javaPackageName":"com.boiboif.reactnativetoast"}},"prettier":{"quoteProps":"consistent","singleQuote":true,"tabWidth":2,"trailingComma":"es5","useTabs":false},"create-react-native-library":{"type":"turbo-module","languages":"kotlin-objc","tools":["eslint"],"version":"0.63.0"},"gitHead":"bcfff713193e5d3f56524a375b2762e057da1985","_id":"@boiboif/react-native-toast@0.1.0","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-0/iXzjZMMMZ8Ri9u2vD715hVy1BMa+7YFNtEP/PK/ukiDW2eQHATSqqnqOXOF/wG5Yb+aP6PFy2vjnntavCZxA==","shasum":"6c56502fe2300a8ee5eb19ecddf103a1b21076a3","tarball":"https://registry.npmjs.org/@boiboif/react-native-toast/-/react-native-toast-0.1.0.tgz","fileCount":35,"unpackedSize":75607,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIQC0o3On6V2QuYCHaNSgpv5DQrs9O8JXBW2LW5HJafNpPQIfSKYkXfI5l12dzQSNg3qTYgbu9ndF4wDW/ILtGxxMjg=="}]},"_npmUser":{"name":"boiboif","email":"dg70946@163.com"},"directories":{},"maintainers":[{"name":"boiboif","email":"dg70946@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/react-native-toast_0.1.0_1786096786486_0.7973177580958299"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-07T09:59:46.351Z","0.1.0":"2026-08-07T09:59:46.628Z","modified":"2026-08-07T09:59:46.864Z"},"maintainers":[{"name":"boiboif","email":"dg70946@163.com"}],"description":"A customizable native toast library for React Native New Architecture","homepage":"https://boiboif.github.io/react-native-toast/","keywords":["react-native","toast","turbo-module","new-architecture","ios","android"],"repository":{"type":"git","url":"git+https://github.com/boiboif/react-native-toast.git"},"author":{"name":"boiboif","email":"boiboif@users.noreply.github.com","url":"https://github.com/boiboif"},"bugs":{"url":"https://github.com/boiboif/react-native-toast/issues"},"license":"MIT","readme":"# @boiboif/react-native-toast\n\n[English](README.md) | [简体中文](README.zh-CN.md)\n\n[![npm version](https://img.shields.io/npm/v/%40boiboif%2Freact-native-toast)](https://www.npmjs.com/package/@boiboif/react-native-toast)\n[![npm downloads](https://img.shields.io/npm/dm/%40boiboif%2Freact-native-toast)](https://www.npmjs.com/package/@boiboif/react-native-toast)\n[![CI](https://github.com/boiboif/react-native-toast/actions/workflows/ci.yml/badge.svg)](https://github.com/boiboif/react-native-toast/actions/workflows/ci.yml)\n[![license](https://img.shields.io/npm/l/%40boiboif%2Freact-native-toast)](LICENSE)\n\n一个类型完善、可自定义的 React Native 原生 Toast 库，专为新架构构建。\n它同时支持 React Native bare 项目和 Expo Development Build，不依赖 Expo\nModules。\n\n## 特性\n\n- 基于 TurboModule，仅面向 React Native 新架构\n- 同时支持 React Native bare 与 Expo prebuild/development build\n- Android 基于 [getActivity/Toaster](https://github.com/getActivity/Toaster)\n- iOS 使用原生 UIKit 实现\n- 内置成功、错误、警告和信息四种预设\n- 支持位置、时长、偏移、颜色、字号、内边距和圆角配置\n- 支持立即隐藏和全局默认配置\n- 完整 TypeScript 类型和 React Native 自动链接\n\n## 兼容性\n\n| 环境 | 支持情况 |\n| --- | --- |\n| React Native bare 新架构项目 | 支持 |\n| Expo prebuild / Development Build / EAS Build | 支持 |\n| Expo Go | 不支持自定义原生模块 |\n| React Native 旧架构 | 不支持 |\n| Web | 安全空实现 |\n\n要求 React Native `>=0.76`、开启新架构且 Android API 不低于 24。iOS\n最低部署版本跟随当前 React Native 版本的要求。\n\n## 安装\n\n```sh\nnpm install @boiboif/react-native-toast\n```\n\n或使用 Yarn：\n\n```sh\nyarn add @boiboif/react-native-toast\n```\n\niOS 安装后需要更新 CocoaPods：\n\n```sh\nnpx pod-install\n```\n\n原生模块由 autolinking 自动注册，无需手动修改应用入口。\n\n### Expo\n\n```sh\nnpx expo install @boiboif/react-native-toast\nnpx expo prebuild\nnpx expo run:android\n# 或：npx expo run:ios\n```\n\n加入原生依赖后必须重新构建 Development Client。本库无法在 Expo Go 中运行。\n\n### Android 与 JitPack\n\nAndroid 依赖托管在 JitPack 的 `com.github.getActivity:Toaster:13.8`。库本身\n已经声明仓库。如果应用通过 `settings.gradle` 强制统一管理仓库，请加入：\n\n```groovy\ndependencyResolutionManagement {\n  repositories {\n    google()\n    mavenCentral()\n    maven { url = uri(\"https://jitpack.io\") }\n  }\n}\n```\n\n## 快速开始\n\n```ts\nimport Toast from '@boiboif/react-native-toast';\n\nToast.show('操作完成');\nToast.success('保存成功');\nToast.error('保存失败');\nToast.warning('请检查输入内容');\nToast.info('发现新版本');\n```\n\n## 自定义样式\n\n```ts\nToast.show('自定义 Toast', {\n  duration: 'long',\n  position: 'top',\n  xOffset: 0,\n  yOffset: 12,\n  style: {\n    backgroundColor: '#111111',\n    textColor: '#FFFFFF',\n    textSize: 16,\n    borderRadius: 8,\n    paddingHorizontal: 20,\n    paddingVertical: 12,\n    maxLines: 2,\n  },\n});\n```\n\n颜色支持 `#RRGGBB`、`#AARRGGBB` 或数字形式的 `0xAARRGGBB`。\n\n## 全局配置\n\n```ts\nToast.config({\n  defaultOptions: {\n    duration: 'short',\n    position: 'bottom',\n    style: {\n      backgroundColor: '#111111',\n      textColor: '#FFFFFF',\n    },\n  },\n  presetStyles: {\n    success: { backgroundColor: '#16A34A' },\n    error: { backgroundColor: '#DC2626' },\n    warning: { backgroundColor: '#F59E0B' },\n    info: { backgroundColor: '#2563EB' },\n  },\n});\n```\n\n样式优先级依次为：单次调用样式、预设样式、全局默认样式。\n\n## API 概览\n\n```ts\nToast.show(message, options?)\nToast.success(message, options?)\nToast.error(message, options?)\nToast.warning(message, options?)\nToast.info(message, options?)\nToast.hide()\nToast.config(config)\nToast.showSystem(message)\n```\n\n包内同时导出了 `ToastOptions`、`ToastStyleOptions`、`ToastConfig`、\n`ToastPosition`、`ToastDuration` 和 `ToastPreset` 类型。\n\n完整 API、Expo 集成、平台行为与问题排查请阅读\n[在线文档](https://boiboif.github.io/react-native-toast/)。\n\n## 本地开发\n\n```sh\nyarn\nyarn typecheck\nyarn lint\nyarn prepare\nyarn docs:dev\n```\n\n使用 `yarn docs:build` 生成静态文档站点。\n\n## 许可证\n\nMIT\n","readmeFilename":"README.zh-CN.md","_rev":"1-b8685a96643b4ea1985902fd75c93d3b"}