App Expiry

Ship with confidence. Lock the app until you get paid.

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

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

Overview

_{🔒 Expiry Deadlline App}

_{🖼 Branding Watermark}

Delivered the app. Client ghosts you. Sound familiar? `flutter_app_expiry` lets you ship a fully functional build that automatically locks itself on your terms — so you stay in control until the invoice is settled. Ideal for freelancers, agencies, and indie developers who need a reliable payment deadline gate without writing it from scratch.

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

That's it. One widget wraps everything.

✦ Features


🔒 Payment deadline gate	App locks on your terms — no payment, no access
🎨 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
🖼 Unpaid branding	Stamp every screen with your watermark until the client pays
🪶 Zero extra dependencies	Pure Flutter — nothing added to your dependency tree

📦 Getting Started

1. Install

# pubspec.yaml
dependencies:
  flutter_app_expiry: ^latest-version

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: 'support@yourapp.com',
  child: const MyApp(),
)

Option C — Embed `DefaultExpiredScreen` directly

DefaultExpiredScreen(
  expiryDate: DateTime(2026, 12, 31),
  title: 'License Expired',
  message: 'Renew to keep going.',
  contactInfo: 'hello@example.com',
)

🖼 Watermark Overlay

Need to brand a demo build or remind unpaid clients they're on a trial? The watermark overlay floats above your entire app UI — persistent, unobtrusive, and impossible to miss.

Common use cases:

Demo apps — make it clear the build isn't production-ready
Unpaid clients — reinforce that a license is still pending
Internal builds — distinguish staging from release

Text watermark (default)

ExpiryApp(
  expiryDate: DateTime(2026, 12, 31),
  watermark: WatermarkConfig(
    text: 'DEMO',
    color: Colors.red,
    opacity: 0.15,
    angle: -0.4,
    repeat: true,
    tileSpacing: 140.0,
  ),
  child: const MyApp(),
)

Image watermark

Pass any asset image path via imagePath. Make sure the asset is declared in your pubspec.yaml.

ExpiryApp(
  expiryDate: DateTime(2026, 12, 31),
  watermark: WatermarkConfig(
    imagePath: 'assets/logo.png',  // your asset path
    imageSize: Size(80, 80),       // tile size (optional, default 80×80)
    opacity: 0.15,
    angle: -0.4,
    repeat: true,
    tileSpacing: 140.0,
  ),
  child: const MyApp(),
)

Note: When imagePath is set, text, textStyle, and color are ignored — image mode takes priority.

Single centered image (no tiling):

WatermarkConfig(
  imagePath: 'assets/logo.png',
  repeat: false,  // renders once, centered
)

The watermark renders above your app's UI at all times and ignores all touch events so it never blocks user interaction.

🧮 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
`watermark`	`WatermarkConfig?`	—	Watermark overlay for demo/trial branding

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

`WatermarkConfig`

Parameter	Type	Default	Description
`text`	`String?`	`'DEMO'`	Text label shown as watermark. Ignored when `imagePath` is set.
`textStyle`	`TextStyle?`	`null`	Custom style for text. Falls back to `color` + 24sp bold.
`imagePath`	`String?`	`null`	Asset path to an image watermark (e.g. `'assets/logo.png'`). Takes priority over `text`.
`imageSize`	`Size`	`Size(80, 80)`	Width and height of each image tile.
`opacity`	`double`	`0.15`	Overall opacity of the watermark (0.0–1.0).
`angle`	`double`	`-0.4`	Rotation in radians. Negative = diagonal tilt.
`repeat`	`bool`	`true`	Tile the watermark across the whole screen.
`tileSpacing`	`double`	`140.0`	Spacing between tiles when `repeat` is `true`.
`color`	`Color`	`Colors.grey`	Text color when no `textStyle` is provided. Text mode only.
`showOnExpiredScreen`	`bool`	`false`	Whether to show the watermark on the expired screen too.

`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
│       └── watermark_overlay.dart    # Watermark overlay 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.

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

📄 License

Made with ♥ for the Flutter community

App Expiry

Overview

✦ Features

📦 Getting Started

1. Install

2. Wrap your app

🎨 Customization

Option A — Use your own expired screen

Option B — Customize the built-in screen

Option C — Embed `DefaultExpiredScreen` directly

🖼 Watermark Overlay

Text watermark (default)

Image watermark

🧮 ExpiryService

📚 API Reference

`ExpiryApp`

`WatermarkConfig`

`ExpiryService`

📂 Project Structure

🤝 Contributing

📄 License

Libraries

flutter_app_expiry package

App Expiry

Overview

✦ Features

📦 Getting Started

1. Install

2. Wrap your app

🎨 Customization

Option A — Use your own expired screen

Option B — Customize the built-in screen

Option C — Embed DefaultExpiredScreen directly

🖼 Watermark Overlay

Text watermark (default)

Image watermark

🧮 ExpiryService

📚 API Reference

ExpiryApp

WatermarkConfig

ExpiryService

📂 Project Structure

🤝 Contributing

📄 License

Libraries

flutter_app_expiry package

Option C — Embed `DefaultExpiredScreen` directly

`ExpiryApp`

`WatermarkConfig`

`ExpiryService`