niduranga/laravel-dev-guard

AI-powered TDD test generator for Laravel Actions

Maintainers

Package info

github.com/niduranga/laravel-dev-guard

pkg:composer/niduranga/laravel-dev-guard

Statistics

Installs: 22

Dependents: 0

Suggesters: 0

Stars: 1

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v2.1.0 2026-04-18 05:23 UTC

Requires

Requires (Dev)

MIT 41234c81837ae3f9d216d8fc332333b36a3a8d03

  • Niduranga <nidurangajayarathna.woop@gmail.com>

This package is auto-updated.

Last update: 2026-04-18 05:26:01 UTC

README

Laravel DevGuard is an AI-powered TDD companion designed specifically for the Laravel Action pattern. It automates the tedious task of writing unit and feature tests by analyzing your business logic and generating production-ready Pest or PHPUnit tests using Google's Gemini AI.

Stop being a "Balu" developer spending hours on boilerplate tests. Focus on the logic, and let DevGuard handle the coverage.

🚀 Features

  • Auto-Framework Detection: Automatically detects whether your project uses Pest or PHPUnit.
  • Context-Aware Generation: Analyzes your Action classes and intelligently mocks dependencies.
  • One-Command Setup: Seamless installation and configuration.
  • Gemini AI Powered: Uses high-speed, high-accuracy LLMs to understand your code flow.
  • SOLID Compliant: Generates tests that follow clean architecture and best practices.

📦 Installation

You can install the package via composer:

composer require niduranga/laravel-dev-guard

After the package is installed, run the installation command to publish the configuration file:

php artisan devguard:install

⚙️ Configuration

  1. Get your free API Key from the Google AI Studio.
  2. Add the following key to your .env file:
GEMINI_API_KEY=your_actual_api_key_here

# Optional: Defaults to gemini-2.5-flash for high performance you can change to other models
GEMINI_MODEL=gemini-3-flash-preview

🛠️ Usage

Simply point DevGuard to any Action class in your project.

php artisan guard:test Actions/CreateUserAction

What happens next?

  1. Scanning: DevGuard reads your CreateUserAction class.
  2. Analysis: It identifies DB interactions, events, and external API calls.
  3. Generation: AI generates a comprehensive test suite.
  4. Saving: The test file is automatically saved in tests/Feature/ or tests/Unit/.

✅ Testing

We take testing seriously. This package is fully tested with Pest.

composer test

🤝 Contributing

Contributions are welcome! If you have ideas for new features or improvements, feel free to open an issue or submit a pull request.

📄 License

The MIT License (MIT). Please see License File for more information.

Developed with ❤️ by Niduranga Jayarathna