🇺🇸 English | 🇹🇷 Türkçe

SubZilla

SubZilla is a powerful and intuitive Flutter application designed to help you manage your monthly subscriptions, track recurring expenses, and stay in control of your budget.

With recent major updates, SubZilla now offers an even smoother experience with enhanced performance, new features, and a polished design.

🏠 Home Screen

Light Mode	Dark Mode

📊 Analytics

Light Mode	Dark Mode

📅 Calendar

Light Mode	Dark Mode

✨ Features

• Subscription Tracking: Keep all your subscriptions in one place.
• Visual Analytics: Interactive charts to visualize your spending trends (fl_chart).
• Calendar View: Manage payments with a monthly calendar view.
• Smart Notifications: Get notified before a payment is due, so you never miss a beat.
• Local Database: Your data is yours. Securely stored on your device using sqflite.
• Multi-Language Support: Available in English and Turkish (easy_localization).
• Customizable Experience: Dark mode, custom themes, and currency settings.
• State Management: Built with modern Riverpod for robust and testable code.

🚀 Getting Started

Follow these steps to download the source code and set up your development environment.

Prerequisites

• Flutter SDK installed.
• Git installed.

Installation

1. Clone the Repository

   git clone https://github.com/DevOpen-io/SubZilla.git
   cd SubZilla

2. Install Dependencies Fetch the necessary packages:

   flutter pub get

3. Run Code Generation This project uses freezed and riverpod_generator. You need to run the build runner to generate the necessary files:

   dart run build_runner build -d

4. Run the Application Connect a device or start an emulator, then run:

   flutter run

📖 How to Use

1. Add a Subscription: Navigate to the add screen, select a brand (or create a custom one), enter the amount, and set the billing cycle.
2. Monitor Dashboard: Check the home dashboard to see your total monthly/yearly expenses and upcoming payments.
3. Manage Settings: Go to settings to toggle dark mode, change language, or adjust notification timing.

🤝 Contributing & Support

We love contributions! If you have ideas for new features or have found a bug, here is how you can help:

• Report Issues: Use the GitHub Issues tab to report bugs or request features.
• Submit Pull Requests: Fork the repository, make your changes, and submit a PR. Please ensure your code follows the project's style and passes all tests.
• Support: Give the project a star ⭐ to show your support!

---

SubZilla

SubZilla, aylık aboneliklerinizi yönetmenize, tekrarlayan harcamalarınızı takip etmenize ve bütçenizi kontrol altında tutmanıza yardımcı olmak için tasarlanmış güçlü ve sezgisel bir Flutter uygulamasıdır.

Son büyük güncellemelerle birlikte SubZilla, gelişmiş performans, yeni özellikler ve cilalanmış bir tasarımla çok daha akıcı bir deneyim sunuyor.

🏠 Ana Ekran

Aydınlık Mod	Karanlık Mod

📊 Analizler

Aydınlık Mod	Karanlık Mod

📅 Takvim

Aydınlık Mod	Karanlık Mod

✨ Özellikler

• Abonelik Takibi: Tüm aboneliklerinizi tek bir yerde tutun.
• Görsel Analizler: Harcama trendlerinizi görselleştirmek için etkileşimli grafikler (fl_chart).
• Takvim Görünümü: Aylık takvim görünümü ile ödemelerinizi yönetin.
• Akıllı Bildirimler: Ödeme günü yaklaşmadan bildirim alın, böylece hiçbir ödemeyi kaçırmazsınız.
• Yerel Veritabanı: Verileriniz size aittir. sqflite kullanılarak cihazınızda güvenle saklanır.
• Çoklu Dil Desteği: İngilizce ve Türkçe (easy_localization) seçenekleri mevcuttur.
• Özelleştirilebilir Deneyim: Karanlık mod, özel temalar ve para birimi ayarları.
• Durum Yönetimi: Sağlam ve test edilebilir kod için modern Riverpod ile oluşturulmuştur.

🚀 Başlarken

Kaynak kodunu indirmek ve geliştirme ortamınızı kurmak için aşağıdaki adımları izleyin.

Ön Koşullar

• Flutter SDK yüklü olmalıdır.
• Git yüklü olmalıdır.

Kurulum

1. Depoyu Klonlayın

   git clone https://github.com/DevOpen-io/SubZilla.git
   cd SubZilla

2. Bağımlılıkları Yükleyin Gerekli paketleri indirin:

   flutter pub get

3. Kod Üretimini Çalıştırın Bu proje freezed ve riverpod_generator kullanır. Gerekli dosyaları oluşturmak için build runner'ı çalıştırmanız gerekir:

   dart run build_runner build -d

4. Uygulamayı Çalıştırın Bir cihaz bağlayın veya emülatörü başlatın, ardından çalıştırın:

   flutter run

📖 Nasıl Kullanılır

1. Abonelik Ekle: Ekle ekranına gidin, bir marka seçin (veya özel bir tane oluşturun), tutarı girin ve faturalandırma döngüsünü ayarlayın.
2. Paneli İzleyin: Aylık/yıllık toplam harcamalarınızı ve yaklaşan ödemelerinizi görmek için ana paneli kontrol edin.
3. Ayarları Yönetin: Karanlık modu açmak, dili değiştirmek veya bildirim zamanlamasını ayarlamak için ayarlara gidin.

🤝 Katkıda Bulunma ve Destek

Katkıları seviyoruz! Yeni özellikler için fikirleriniz varsa veya bir hata bulduysanız, işte nasıl yardımcı olabileceğiniz:

• Sorun Bildirin: Hataları bildirmek veya özellik istemek için GitHub Issues sekmesini kullanın.
• Pull Request Gönderin: Depoyu fork'layın, değişikliklerinizi yapın ve bir PR gönderin. Lütfen kodunuzun proje stiline uyduğundan ve tüm testleri geçtiğinden emin olun.
• Destek: Desteğinizi göstermek için projeye bir yıldız ⭐ verin!

---

📈 Star History / Yıldız Geçmişi