PHPackages                             fortephp/sheath-super-native - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. fortephp/sheath-super-native

ActiveLibrary

fortephp/sheath-super-native
============================

Sheath rules for NativePHP Mobile Blade views: native element, class, and idiom linting for super native templates.

v0.1.0(yesterday)11↑2900%MITPHPPHP ^8.4CI passing

Since Aug 24Pushed yesterdayCompare

[ Source](https://github.com/fortephp/sheath-super-native)[ Packagist](https://packagist.org/packages/fortephp/sheath-super-native)[ GitHub Sponsors](https://github.com/johnathonkoster)[ RSS](/packages/fortephp-sheath-super-native/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (7)Versions (2)Used By (0)

Sheath SuperNative
==================

[](#sheath-supernative)

Catch mistakes in [NativePHP SuperNative](https://nativephp.com/docs/mobile/4/getting-started/introduction) Blade views before they reach a device.

This [Sheath](https://github.com/fortephp/sheath) plugin understands native elements, event and model bindings, NativePHP's Tailwind subset, layout rules, themes, and accessibility conventions. It reports problems directly in your Blade views without rendering a screen or launching an app.

Installation
------------

[](#installation)

```
composer require --dev fortephp/sheath-super-native
```

Laravel discovers the package automatically. If your application does not have a Sheath config yet, publish it:

```
php artisan vendor:publish --tag=sheath-config
```

Then add the `nativephp` preset to `config/sheath.php`:

```
'preset' => ['recommended', 'nativephp'],
```

Keep `nativephp` after the built-in presets. Later presets win, and this ordering prevents web-focused HTML rules from reporting native markup.

Run Sheath normally:

```
php artisan sheath:lint
```

You can also try the plugin without changing your config:

```
php artisan sheath:lint --preset=nativephp
```

Usage
-----

[](#usage)

Sheath scans its configured view paths by default. You can also lint a directory or one file:

```
php artisan sheath:lint resources/views/native
php artisan sheath:lint resources/views/native/home.blade.php
```

Some spelling mistakes have safe fixes:

```
php artisan sheath:lint --fix
```

Use `php artisan sheath:lint --print-config` to see every active rule and severity.

What it catches
---------------

[](#what-it-catches)

- unknown, incomplete, or unbalanced native elements;
- discarded HTML, unsupported attributes, invalid enum values, and malformed line points;
- unsupported events, missing callbacks, invalid navigation transitions, and callback argument mismatches;
- model bindings on the wrong element or properties that are missing, private, readonly, or locked;
- missing, duplicate, constant, or position-based keys in repeated content;
- unsupported Tailwind utilities and classes that NativePHP interprets differently than written;
- incomplete borders, ignored dark variants, invalid glass modifiers, and misplaced text styles;
- invalid native layout structure, duplicate safe-area padding, undefined theme tokens, and unnamed icon controls.

Diagnostics point to the authored Blade element rather than generated compiler output, so the problem is easier to find and fix.

The plugin reads registered SuperNative elements, components, attributes, events, and theme behavior from the installed NativePHP runtime. Plugin-provided features are recognized automatically, while dynamic behavior the linter cannot verify is left alone instead of guessed at.

Configuration
-------------

[](#configuration)

You can override individual rules in `config/sheath.php`:

```
'rules' => [
    'native-no-emoji' => 'off',
    'native-prefer-theme-tokens' => 'off',
    'native-key-hygiene' => 'error',
],
```

Native rules target `resources/views/native` by default and also recognize views containing unmistakable SuperNative tags. If your native views live elsewhere, pass a `nativeViewPaths` option to the native rules you enable. Configuring explicit paths switches detection to path-only, which is useful when web components share names with native elements.

Requirements
------------

[](#requirements)

- PHP 8.4 or newer
- Laravel 12 or 13
- NativePHP Mobile 4.2 or newer within the 4.x series (SuperNative)
- Sheath 1.x

License
-------

[](#license)

MIT. See [license.md](license.md).

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance100

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a83ab8381df8c78dbe4acc582ab8b0c0202dfa5f59a4c837b32d78a2bafc0fe7?d=identicon)[stillat](/maintainers/stillat)

---

Top Contributors

[![JohnathonKoster](https://avatars.githubusercontent.com/u/5232890?v=4)](https://github.com/JohnathonKoster "JohnathonKoster (2 commits)")

---

Tags

laravelblade linter

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/fortephp-sheath-super-native/health.svg)

```
[![Health](https://phpackages.com/badges/fortephp-sheath-super-native/health.svg)](https://phpackages.com/packages/fortephp-sheath-super-native)
```

###  Alternatives

[rtconner/laravel-likeable

Trait for Laravel Eloquent models to allow easy implementation of a 'like' or 'favorite' or 'remember' feature.

392399.0k5](/packages/rtconner-laravel-likeable)[hemp/presenter

Easy Model Presenters in Laravel

247625.4k1](/packages/hemp-presenter)[slowlyo/owl-admin

基于 laravel、amis 开发的后台框架~

61415.2k26](/packages/slowlyo-owl-admin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)