cypher_encrypt 0.0.1

A simple, flexible Dart package for encrypting and decrypting strings using a customizable substitution cypher. Supports custom sequences, variable steps, and works with any UTF-8 string.

cypher_encrypt

A simple, flexible Dart package for encrypting and decrypting strings using a customizable substitution cipher.

You can shift characters by a number of steps, define your own sequence, and safely encrypt/decrypt any UTF-8 text.
Characters not included in the sequence remain unchanged.

---

✨ Features

• 🔐 Encryption & decryption with a substitution cipher
• 🔄 Customizable steps (shift forward/backward by N)
• 📝 Default sequence provided, but you can override with your own
• 🌍 Works with any UTF-8 string (letters, numbers, symbols, emojis)
• 🛡️ Safe by design: no FormatException because we don’t rely on Base64

---

📦 Installation

Add this line to your pubspec.yaml under dependencies:

dependencies:
  cypher_encrypt: ^0.0.1

Then run: dart pub get

---

🚀 Usage Example

import 'package:cypher_encrypt/cypher_encrypt.dart';

void main() {
final text = "Cypher the like button!";

// Encrypt with steps = 3
final encrypted = cypherEncrypt(text, steps: 3);
print("Encrypted: $encrypted");

// Decrypt with the same steps
final decrypted = cypherDecrypt(encrypted, steps: 3);
print("Decrypted: $decrypted");

// Wrong steps → produces gibberish
final wrong = cypherDecrypt(encrypted, steps: 2);
print("Wrong decryption: $wrong");
}

👀 Example Output

Encrypted: FBskhubwkhbolnhbexwwrq%
Decrypted: Cypher the like button!
Wrong decryption: Dzqifs-uif-mjlf-cvuupo@

---

🔑 Default Sequence

By default, cypher_encrypt uses this sequence: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789=+!@#%&*()_ -

• ✅ Works for letters, numbers, and common symbols
• ✅ You can override with your own sequence
• ✅ Characters not in the sequence remain unchanged

---

💁🏼 Custom Sequence Example

final encrypted = cypherEncrypt(
"Hello World!",
sequence: "zyxwvutsrqponmlkjihgfedcba", // reversed alphabet
steps: 5,
);

final decrypted = cypherDecrypt(
encrypted,
sequence: "zyxwvutsrqponmlkjihgfedcba",
steps: 5,
);

---

📜 License

MIT License © 2025 Muhammad Rameez

---