📦 react-native-aes-lite

$3

Hermes-Safe • Expo-Ready • Pure JavaScript • Zero Native Modules

!platforms
!typescript
!bundle size
!license

react-native-aes-lite is a pure JavaScript AES-CBC encryption library made specifically for React Native.

It works on:
- Hermes (Android & iOS)
- Expo (managed + bare)
- React Native CLI
- Web
- Expo Snack (supported)

No native modules.
Zero dependencies.
Perfect for lightweight secure storage and payload obfuscation.

✨ Features

| Feature | Status |
|--------|--------|
| 🔐 AES-128 / AES-192 / AES-256 | ✅ |
| 🧬 CBC mode w/ PKCS7 padding | ✅ |
| 🔑 Hex or ASCII key support | ✅ |
| 🔥 Hermes-safe UTF-8 encode/decode | ✅ |
| 🌐 Android / iOS / Web support | ✅ |
| 🚫 No native modules required | ✅ |
| 📦 ~6KB bundle size | ✅ |
| 🔄 Includes generateKey() helper | ✅ |
| 🧪 Works inside Expo Snack | ✅ |

📦 Installation

npm install react-native-aes-lite
or
yarn add react-native-aes-lite

🔑 Key Generation

``js
import { generateKey } from "react-native-aes-lite";
const key = generateKey("hex", { length: 32 });
`

$3

| AES | ASCII | Hex |
|-----|--------|------|
| AES-128 | 16 chars | 32 hex |
| AES-192 | 24 chars | 48 hex |
| AES-256 | 32 chars | 64 hex |

🔐 Encrypt / Decrypt Example

`js
import { AES, generateKey } from "react-native-aes-lite";
const aes = new AES();
const key = generateKey("hex", { length: 32 });
const encrypted = aes.encrypt("hello sreeraj", key);
const decrypted = aes.decrypt(encrypted, key);
console.log(encrypted, decrypted);
`

Example output:
`
Encrypted: :
Decrypted: hello sreeraj
``

🧠 API Reference

$3

- encrypt(text, key)
- decrypt(payload, key)

$3

Formats: hex, base64, ascii

⚠ Security Notes

- Hermes fallback RNG is not cryptographically secure.
- Not suitable for banking/military-level encryption.
- Safe for lightweight local data protection.

📊 Benchmarks (Hermes – Pixel 6)

| Payload | Encrypt | Decrypt |
|---------|---------|---------|
| 32 bytes | ~0.18 ms | ~0.17 ms |
| 128 bytes | ~0.42 ms | ~0.40 ms |
| 1 KB | ~2.9 ms | ~2.8 ms |
| 10 KB | ~29 ms | ~28 ms |

🗺 Roadmap

- AES-GCM mode
- HMAC-SHA256
- Streaming encryption
- TypeScript typings
- ESM build
- Secure RNG polyfill for Hermes

🤝 Contributing

PRs welcome. city0666@gmail.com

Support

#### IF you need suggestion and support regarding this package
https://github.com/city0666

📜 License

MIT © 2025 Ammachi