flutter_app_expiry 0.0.3

A Flutter package to enforce app expiration (trial period) based on a specific date. After the expiry date, the app is blocked and shows a customizable expiration screen.

App Expiry

Enforce trial periods in Flutter apps — beautifully.

Set an expiry date. Ship your app. Everything else is handled.

Getting Started · API Reference · Customization · pub.dev →

---

Overview

`flutter_app_expiry` lets you ship Flutter apps with a built-in expiration gate — ideal for trial builds, demos, or time-limited licenses. When the clock runs out, your app gracefully shows a polished lock screen instead of crashing or misbehaving.

ExpiryApp(
  expiryDate: DateTime(2026, 12, 31),
  child: const MyApp(),
)

That's it. One widget wraps everything.

---

✦ Features

🔒 Hard expiry gate	Blocks the app after a configurable date — no workarounds
🎨 Beautiful default UI	Animated lock screen with gradient, shown out of the box
🛠 Fully replaceable	Swap in your own expired widget with a single parameter
📅 ExpiryService utility	Query remaining days or duration programmatically
🪶 Zero extra dependencies	Pure Flutter — nothing added to your dependency tree

---

📦 Getting Started

1. Install

# pubspec.yaml
dependencies:
  flutter_app_expiry: ^0.0.1

flutter pub get

2. Wrap your app

import 'package:flutter/material.dart';
import 'package:flutter_app_expiry/flutter_app_expiry.dart';

void main() {
  runApp(
    ExpiryApp(
      expiryDate: DateTime(2026, 12, 31), // 🔑 set your date
      child: const MyApp(),
    ),
  );
}

Done. The app runs normally until expiryDate — then the lock screen takes over automatically.

---

🎨 Customization

Option A — Use your own expired screen

ExpiryApp(
  expiryDate: DateTime(2026, 12, 31),
  expiredWidget: const MyCustomExpiredScreen(), // full control
  child: const MyApp(),
)

Option B — Customize the built-in screen

ExpiryApp(
  expiryDate: DateTime(2026, 12, 31),
  expiredTitle: 'Trial Ended',
  expiredMessage: 'Please purchase a license to continue.',
  contactInfo: '[e-mail]',
  child: const MyApp(),
)

Option C — Embed DefaultExpiredScreen directly

DefaultExpiredScreen(
  expiryDate: DateTime(2026, 12, 31),
  title: 'License Expired',
  message: 'Renew to keep going.',
  contactInfo: '[e-mail]',
)

---

🧮 ExpiryService

Need to react to expiry in your own logic? Use ExpiryService for programmatic checks:

final service = ExpiryService();
final expiry = DateTime(2026, 12, 31);

// Check expiry state
final expired = service.isExpired(expiry);          // bool

// How much time is left?
final days     = service.remainingDays(expiry);     // int  (e.g. 42)
final duration = service.remainingDuration(expiry); // Duration

Great for showing in-app banners like "Your trial expires in 7 days".

---

📚 API Reference

ExpiryApp

Parameter	Type	Required	Description
expiryDate	DateTime	✅	The date the app will be blocked
child	Widget	✅	Your root app widget
expiredWidget	Widget?	—	Fully custom expired screen
expiredTitle	String?	—	Title on the default screen
expiredMessage	String?	—	Message on the default screen
contactInfo	String?	—	Contact text on the default screen

expiredWidget takes precedence — if provided, expiredTitle, expiredMessage, and contactInfo are ignored.

ExpiryService

Method	Returns	Description
isExpired(DateTime)	bool	true if the date has passed
remainingDays(DateTime)	int	Full calendar days remaining
remainingDuration(DateTime)	Duration	Precise duration until expiry

---

📂 Project Structure

flutter_app_expiry/
├── lib/
│   ├── flutter_app_expiry.dart       # Public barrel export
│   └── src/
│       ├── expiry_service.dart       # Core expiry logic
│       ├── expiry_screen.dart        # Default animated UI
│       └── expiry_widget.dart        # ExpiryApp wrapper widget
├── example/
│   └── lib/main.dart
├── pubspec.yaml
├── CHANGELOG.md
├── README.md
└── LICENSE

---

🤝 Contributing

Issues and pull requests are welcome! If you find a bug or have a feature idea, please open an issue.

1. Fork the repo
2. Create your feature branch: git checkout -b feat/amazing-thing
3. Commit your changes: git commit -m 'feat: add amazing thing'
4. Push and open a PR

---

📄 License

MIT © see LICENSE for details.

---

Made with ♥ for the Flutter community