README

Postman-like API test interface, directly inside your Laravel application.
Zero configuration, local-only, session-backed, and fully extensible.

Why Laranova?

You're debugging an API endpoint, testing validation rules, or inspecting a third-party integration. Normally you'd switch to Postman, Insomnia, or cURL — copy URLs, manage tokens, keep windows in sync.

Laranova lives inside your Laravel app. It scans all your routes, auto-detects validation rules, generates fake data via Faker, and lets you send requests — all from a single-page interface served at /laranova.

Features

Installation

composer require --dev ug-code/laranova

Laranova uses package auto-discovery. No manual service provider registration needed.

Quick Start

Navigate to /laranova in your browser. That's it.

The interface only loads in local environment. If you need to test in other environments:

# config/app.php
'providers' => [
    // ...
    \Laranova\LaranovaServiceProvider::class,
],

Then set APP_ENV=local or temporarily remove the environment check from the provider.

Usage

Sending a Request

1. Select an HTTP method from the dropdown.
2. Enter the full URL (or use {{baseUrl}}/api/endpoint).
3. Add headers, query params, and body as needed.
4. Optionally write pre-scripts.
5. Click Send Request.

Selecting Routes from the Sidebar

The left panel lists all application routes (excluding debug/telescope paths). Routes are grouped by controller. Click a route to auto-fill method, URL, query parameters, and body — including validation-rule-aware faker values.

Using Faker Tags

Any text field supports faker tag replacement. Tags are resolved fresh on each request:

Unknown tag types fall back to word.

Configuration

Publish the config file:

php artisan vendor:publish --tag=laranova-config

// config/laranova.php

return [

    'default_headers' => [
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
    ],

    'auto_content_type' => true,  // Auto-add Content-Type for body requests

    'faker' => [
        'locale' => env('LARANOVA_FAKER_LOCALE', 'en_US'),
    ],

    'http' => [
        'timeout'         => env('LARANOVA_HTTP_TIMEOUT', 30),
        'connect_timeout' => env('LARANOVA_HTTP_CONNECT_TIMEOUT', 10),
    ],

    'history' => [
        'max_items' => env('LARANOVA_HISTORY_MAX', 100),
    ],

    'routes' => [
        'exclude_prefixes' => [
            'laranova', '_debugbar', '_ignition', 'telescope', 'sanctum',
        ],
    ],

    'security' => [
        'type'     => env('LARANOVA_SECURITY_TYPE', 'bearer'),  // null, bearer, basic, apikey
        'name'     => env('LARANOVA_SECURITY_NAME', 'api_key'),
        'position' => env('LARANOVA_SECURITY_POSITION', 'header'),
    ],

    'default_variables' => [
        'baseUrl'     => env('LARANOVA_DEFAULT_BASE_URL', 'http://pinsever.test'),
        'bearerToken' => '',
    ],
];

Publishing Views

php artisan vendor:publish --tag=laranova-views

This publishes the Blade SPA to resources/views/vendor/laranova/. You can customize the UI directly. The frontend uses Tailwind CSS and Alpine.js 3.x from CDN — no npm build step required.

Environment Variables

Architecture

src/
├── LaranovaServiceProvider.php     # Routes, views, config, container bindings
├── Facades/Laranova.php            # Facade → ApiClient
├── Http/Controllers/
│   └── LaranovaController.php      # Readonly controller, 6 actions
├── Services/
│   ├── ScriptParser.php            # Regex faker-tag engine
│   ├── ApiClient.php               # Laravel HTTP::send() wrapper
│   └── RouteScanner.php            # Scans all routes, extracts rules & metadata
resources/views/
├── laranova.blade.php              # Single-file SPA (Alpine.js + Tailwind)
├── components/
│   ├── left-sidebar.blade.php      # Route tree + history panel
│   ├── center-panel.blade.php      # Request builder
│   ├── right-panel.blade.php       # Response viewer
│   └── settings-modal.blade.php    # Settings overlay
└── partials/
    ├── tab-headers.blade.php       # Header builder with toggle
    ├── tab-query-params.blade.php  # Query param builder with toggle
    ├── tab-body.blade.php          # Body editor
    ├── tab-pre-scripts.blade.php   # JavaScript pre-script editor
    └── tab-route-info.blade.php    # Selected route details

Routes

All routes are prefixed with /laranova and use the web middleware:

Route names are prefixed with laranova.* (e.g., laranova.index, laranova.resolve).

Pre-scripts API

Laranova implements a subset of the Postman pm.* API:

// Variables
pm.variables.get('key');
pm.variables.set('key', 'value');
pm.variables.unset('key');
pm.variables.clear();
pm.variables.replace('Hello {{name}}');

// Environment (localStorage-backed)
pm.environment.get('key');
pm.environment.set('key', 'value');
pm.environment.unset('key');
pm.environment.clear();

// HTTP requests within pre-scripts
const response = await pm.sendRequest({ method: 'GET', url: '...' });
// callback style:
pm.sendRequest({ ... }, (err, res) => { ... });

Development

composer install

No build step. The frontend uses Tailwind CSS and Alpine.js from CDN.

License

MIT © ug-code