@kuvali-js/core

(https://www.npmjs.com/package/jest)

---

The solid foundation for feature-complete, offline-first React Native mobile apps.

---

⚠️ Note: This project is currently in ALPHA. The API is subject to change. We are working towards a stable foundation. Not recommended for production use yet, but we welcome early adopters and feedback!

---

🚀 Vision

Kuvali-js eliminates the repetitive boilerplate of mobile development. We provide an opinionated, feature-complete core that handles the "heavy lifting" so you can focus on building your app's unique features.

🧠 Our Philosophy (The Kuvali Way)

"It's that easy."

Installing Kuvali gives you a robust, feature-complete mobile app that "just runs" — with professional logging, user management, and offline capabilities out-of-the-box.

A single initCore() is all it takes to get your entire infrastructure running.

Kuvali isn't just a library; it's a technical manifesto for building resilient mobile applications. Our core principles are:

• Offline-First by Design: Data is always available; synchronization happens intelligently in the background.
• Pragmatic Monolith: Integrated services (Auth, DB, Network) that work together seamlessly instead of brittle, loose abstractions.
• Zero-Config Start: We handle the complex initialization of Best-of-Breed packages so you don't have to.

👉 Read our full Core Principles (Architecture & Philosophy)

✨ Core Features (Roadmap)

Kuvali provides a pre-configured suite of services. Everything is initialized via a single initCore() call.

• ✅ Connectivity (CS): Smart network monitoring & request guarding.
• ✅ Observability (Log): Integrated Logging & Error Tracking (BugSink).
• ✅ Offline-First Storage: Powered by WatermelonDB with automatic sync.
• ✅ Reactive Core: Jotai-driven state with functional singletons.
• ✅ i18n: Robust multi-language support out-of-the-box.
• ✅ Themes: Centralized theme management and styling.
• 🏗️ Identity Service: ABAC-based security with OTP Auth (SMS/WhatsApp).
• 📅 Sync-Engine: Automated background data synchronization.

🤝 Join the Journey

Kuvali is built to grow. Our vision is a highly configurable system where you can toggle features or swap providers (DB, Logging, Auth) during installation to generate a stable, custom, and running application tailored to your needs.

We invite you to contribute:

• 💡 Suggest Features: What's missing for your MVP or App?
• 🛠️ Refine the Core: Help us optimize the initialization & interfaces.
• 📖 Improve Docs: Clearer explanations help everyone.

Kuvali lives from the community. Let's build the best foundation for mobile apps together.

Contribute. Extend. Improve.