layerx_generator 2.0.2

A Flutter package that auto-generates a structured LayerX directory with GetX integration, MVVM pattern, and essential services for scalable projects.

LayerX Generator

A Flutter package for auto-generating a structured LayerX architecture with GetX integration.

Overview

layerx_generator simplifies Flutter development by generating a clean, scalable directory structure following the MVVM pattern. It comes with essential service utilities, GetX state management, and pre-configured configurations to streamline project setup.

Features

• Automated MVVM Directory Structure: Generates lib/app/ with organized layers.
• GetX Integration: Preconfigured navigation and state management.
• Built-in Service Utilities: Includes HttpsService, SharedPreferencesHelper, and JsonExtractor.
• Supports Responsive Design: Integrates flutter_screenutil for adaptive UI scaling.
• Flexible Usage: Run via CLI or invoke programmatically in your project.

Installation

Add the package to your project by updating pubspec.yaml:

dependencies:
  layerx_generator: ^2.0.2

Run:

flutter pub get

Usage

Command-Line Execution

To generate the LayerX directory structure, run:

dart run layerx_generator --path .

This command creates the complete LayerX architecture inside lib/app/.

Programmatic Execution

You can also generate the structure dynamically within your code:

import 'package:layerx_generator/layerx_generator.dart';
import 'dart:io';

void main() async {
  final generator = LayerXGenerator(Directory.current.path);
  await generator.generate();
}

Post-Generation Steps

The generated files require additional dependencies. Add the following to pubspec.yaml:

dependencies:
  flutter:
    sdk: flutter
  get: ^4.6.5
  flutter_screenutil: ^5.9.0
  http: ^1.1.0
  shared_preferences: ^2.2.0
  logger: ^2.0.0
  google_fonts: ^6.2.1
  intl: ^0.20.2

Then run:

flutter pub get

Directory Structure

After generation, your project will follow this structured format:

lib/app/
├── config/
│   ├── app_assets.dart
│   ├── app_colors.dart
│   ├── app_enums.dart
│   ├── app_routes.dart
│   ├── app_pages.dart
│   ├── app_strings.dart
│   ├── app_urls.dart
│   ├── app_text_style.dart
│   ├── global_variable.dart
│   ├── padding_extensions.dart
│   ├── utils.dart
│   └── config.dart
├── mvvm/
│   ├── model/
│   │   ├── body_model/
│   │   │   └── example_body_model.dart
│   │   ├── response_model/
│   │   │   └── example_response_model.dart
│   │   └── api_response_model/
│   │       └── api_response.dart
│   ├── view/
│   └── view_model/
├── repository/
│   ├── auth_repo/
│   │   └── example_repo.dart
│   ├── firebase/
│   ├── local_db/
│   └── apis/
├── services/
│   ├── https_service.dart
│   ├── shared_preferences_helper.dart
│   └── json_extractor.dart
└── widgets/

Additionally, it updates:

• lib/app/app_widget.dart: Configures GetX and flutter_screenutil.
• lib/main.dart: Initializes the application.

Example Project

To explore a working implementation, check out the example/ directory.

example/main.dart

import 'package:layerx_generator/layerx_generator.dart';
import 'package:flutter/material.dart';
import 'dart:io';

void main() async {
  final generator = LayerXGenerator(Directory.current.path);
  await generator.generate();
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('LayerX Generator Example')),
        body: const Center(
          child: Text('LayerX structure generated! Check lib/app/'),
        ),
      ),
    );
  }
}

example/pubspec.yaml

name: layerx_generator_example
description: An example project for layerx_generator.
version: 1.0.0

environment:
  sdk: '>=2.18.0 <3.0.0'

dependencies:
  flutter:
    sdk: flutter
  layerx_generator:
    path: ../

dev_dependencies:
  flutter_test:
    sdk: flutter

📦 Changelog

[2.0.2] – 2025-08-24

• Added Notification Services module under services/notifications.
• Firebase Cloud Messaging (FCM) permission handling with proper authorization states.
• Local notification support using flutter_local_notifications.
• Foreground, background, and notification-tap handling hooks.
• Timezone-aware scheduled notifications using timezone + flutter_timezone.
• Device token retrieval utility for backend registration.
• Secure server key helper for FCM HTTP v1 (OAuth access token based).
• Generator now produces notification-ready infrastructure without forcing Firebase initialization, keeping projects compile-safe by default.

---

[2.0.1] – 2025-08-20

• Connection pooling with HTTP/2 multiplexing, TLS resumption, and gzip/deflate for faster handshakes and reduced CPU/RAM usage.
• Concurrency limiter using token-bucket and isolates for JSON parsing, with adaptive concurrency to device cores to prevent socket exhaustion and maintain UI at 60FPS.
• Multi-thread offloading for heavy JSON/XML parsing, compression, and encryption in isolates for smoother main thread and no frame drops.
• Smarter retries with exponential backoff and jitter, tuned for flaky networks to improve recovery and user experience.
• CancelToken for each request, enabling socket abort to save sockets, avoid leaks, and support instant cancellation.
• Timeout control with per-call and global deadlines, auto-closing sockets to prevent hangs and ensure the app never freezes.
• Request deduplication with in-flight cache keyed by URL and params to remove duplicate API hits and save bandwidth.
• Multipart uploads using streams with chunked encoding in background isolate for faster uploads and lower memory usage.
• Centralized headers to auto-attach JWT, device info, and tracing headers for consistent authentication across endpoints.
• Categorized error domains (Timeout, Network, Server, Cancel) with structured logging for improved error handling.
• TLS optimization enforcing modern ciphers and enabling HTTP/2 by default for stronger security and faster requests.
• Adaptive caching supporting ETag, Last-Modified, conditional requests, and in-memory/disk cache for bandwidth savings and instant reloads.
• Monitoring hooks with built-in interceptors for latency, retries, payload size, and socket reuse for easy profiling and SLA tracking.

---

[2.0.0]

• Removed automatic pubspec.yaml modification to prevent overwriting project configurations.
• Users must now manually add required dependencies to pubspec.yaml.

---

[0.0.2]

• Added CLI and programmatic support.
• Improved MVVM structure.
• Included service utilities for HTTP calls, shared preferences, and JSON extraction.

---

[0.0.1]

• Initial release with basic directory generation.

Contributing

Contributions are welcome! If you encounter issues or have feature requests, please open an issue or submit a pull request on GitHub.

LayerX: https://layer-x.netlify.app/

**GitHub Repository: ** https://github.com/Umaiir11/layerx_generator **Medium Blog: ** https://medium.com/@iam.umairimran/layerx-architecture-8e9415d9d624

License

This package is licensed under the BSD 3-Clause License. See the LICENSE file for more details.