Skip to content

kuwaitdevs/cybersecurity_zen_koans_app

Repository files navigation

Cybersecurity Zen Koans 🧘‍♂️🔐

Cybersecurity Zen Koans is an open-source Android application built using Jetpack Compose. It blends ancient Zen wisdom with modern cybersecurity principles in the form of short, thought-provoking koans. The app is designed to encourage mindfulness while deepening awareness of secure digital practices.


✨ Features

  • 🧘 Collection of cybersecurity-themed Zen koans
  • 🎨 Built entirely with Jetpack Compose
  • 🌙 Clean and minimalist UI with dark mode support
  • 🛡️ Koans focused on digital awareness and ethical behavior

🛠️ Tech Stack

  • Kotlin
  • Jetpack Compose
  • Android Studio
  • Material Design 3

🧩 Open Source

This project is proudly open-source under the MIT License. Contributions, suggestions, and pull requests are welcome!


🚀 Getting Started

To run the app locally, follow these steps:

Prerequisites

  • Android Studio Electric Eel or newer
  • Android SDK 33+
  • JDK 17+
  • Git (optional, for cloning)

Steps

  1. Clone the Repository

    git clone https://github.com/yourusername/cybersecurity-zen-koans.git
    cd cybersecurity-zen-koans
  2. Open in Android Studio

    • Open Android Studio.
    • Select "Open an Existing Project".
    • Navigate to the cloned repo and open it.
  3. Build & Run

    • Ensure you have an emulator or physical device configured.
    • Click the Run ▶️ button or use Shift + F10.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


🤝 Contributing

Want to help? Contributions are more than welcome! Check out the CONTRIBUTING.md for guidelines.


💬 Contact

For questions or ideas, feel free to open an issue or reach out via GitHub Discussions.


🧘‍♀️ May your mind be clear, and your passwords complex.