PHPackages                             serhiikorniienko/laravel-kuchi - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. serhiikorniienko/laravel-kuchi

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

serhiikorniienko/laravel-kuchi
==============================

A plug-and-play Laravel package for collecting user feedback and bug reports

0.1.2(10mo ago)316MITPHPPHP ^8.2CI passing

Since Jun 14Pushed 10mo agoCompare

[ Source](https://github.com/SerhiiKorniienko/laravel-kuchi)[ Packagist](https://packagist.org/packages/serhiikorniienko/laravel-kuchi)[ Fund](https://ko-fi.com/serhiikorniienko)[ Patreon](https://www.patreon.com/SerhiiKorniienko)[ RSS](/packages/serhiikorniienko-laravel-kuchi/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (8)Versions (4)Used By (0)

Laravel Kuchi
=============

[](#laravel-kuchi)

[![Laravel Kuchi](art/logo.png)](art/logo.png)

![GitHub Workflow Status](https://camo.githubusercontent.com/72438f4ea59b71991acc37d8d7017b978661ee68937c8fed0efa123ae6101038/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7365726869696b6f726e6969656e6b6f2f6c61726176656c2d6b756368692f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)[![Latest Version on Packagist](https://camo.githubusercontent.com/3cb3c48190d6ba9c7fa07bfce09bc999ac780b24dd1cfeb6c9f01138c26283f5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7365726869696b6f726e6969656e6b6f2f6c61726176656c2d6b756368692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/serhiikorniienko/laravel-kuchi)[![Total Downloads](https://camo.githubusercontent.com/aa7e0b65f26ef599079f365a7209c8bc0f38882413e79e60fe1ddf019ea51d85/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7365726869696b6f726e6969656e6b6f2f6c61726176656c2d6b756368692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/serhiikorniienko/laravel-kuchi)![GitHub License](https://camo.githubusercontent.com/5cf143cc675ac2e8d706c035bc6e74b7ac0af5f319d1a779b9aa1e2834f4b73a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7365726869696b6f726e6969656e6b6f2f6c61726176656c2d6b756368692e7376673f6c6162656c3d6c6963656e7365267374796c653d666c61742d737175617265)

```
In Japanese, "kuchi" (口), pronounced "koo-chee" directly translates to "mouth".

```

A comprehensive Laravel package for collecting user feedback and bug reports with a beautiful, interactive UI built with Livewire.

Features
--------

[](#features)

- 📝 **Feedback Collection** - Allow users to submit feature requests, improvements, and general feedback
- 🐛 **Bug Reporting** - Comprehensive bug reporting with steps to reproduce, browser info, and priority levels
- 👍 **Voting System** - Users can upvote/downvote feedback to prioritize features
- 🎛️ **Admin Dashboard** - Manage all feedback and bug reports with status updates
- 🎨 **Beautiful UI** - Modern, responsive interface built with Tailwind CSS and Livewire
- 🔐 **Authentication** - Only authenticated users can submit feedback (configurable)
- 📊 **Analytics** - Track feedback trends and bug report statistics
- ⚙️ **Configurable** - Extensive configuration options for customization

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

[](#installation)

Install the package via Composer:

```
composer require serhiikorniienko/laravel-kuchi
```

Run the migrations or publish (optional) them to your application:

```
php artisan migrate

php artisan vendor:publish --tag="kuchi-migrations"
```

Publish the configuration file (optional):

```
php artisan vendor:publish --tag="kuchi-config"
```

Publish the views for customization (optional):

```
php artisan vendor:publish --tag="kuchi-views"
```

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

[](#configuration)

The configuration file `config/kuchi.php` allows you to customize:

- Middleware for routes
- Admin users who can access the dashboard
- Categories for feedback
- Bug report priorities
- Status options
- Pagination settings

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

To use the feedback and bug report forms, just provide the link for your users to access the feedback page. Add a button or any interactive element of your choice.

By default, the feedback page is available at `/feedback` (configurable via route prefix).

If you are using Livewire you can add the feedback components to any Blade template:

```

```

### Admin Dashboard

[](#admin-dashboard)

Access the admin dashboard at `/feedback/admin` (configurable via route prefix).

Admin users are defined in the configuration file:

```
'admin_users' => [
    'admin@example.com',
    1, // user ID
],
```

### Routes

[](#routes)

The package registers the following routes:

- `GET /feedback` - Main feedback page
- `GET /feedback/admin` - Admin dashboard

### Models

[](#models)

The package provides three main models:

- `SerhiiKorniienko\LaravelKuchi\Models\Feedback` - User feedback
- `SerhiiKorniienko\LaravelKuchi\Models\BugReport` - Bug reports
- `SerhiiKorniienko\LaravelKuchi\Models\FeedbackVote` - Voting system

Customization
-------------

[](#customization)

### Views

[](#views)

Publish the views to customize the UI:

```
php artisan vendor:publish --tag="kuchi-views"
```

Views will be published to `resources/views/vendor/feedback/`.

### Configuration

[](#configuration-1)

Key configuration options:

```
return [
    'middleware' => ['web', 'auth'],
    'route_prefix' => 'feedback',
    'admin_users' => [
        // Add admin emails or user IDs
    ],
    'categories' => [
        'feature_request' => 'Feature Request',
        'improvement' => 'Improvement',
        'question' => 'Question',
        'other' => 'Other',
    ],
    'bug_priorities' => [
        'low' => 'Low',
        'medium' => 'Medium',
        'high' => 'High',
        'critical' => 'Critical',
    ],
];
```

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

[](#requirements)

- PHP 8.2+
- Laravel 11.0+
- Livewire 3.0+

Screenshots
-----------

[](#screenshots)

### Feedback List

[](#feedback-list)

Interactive list with voting, filtering, and search functionality. [![feedback-list.png](art/feedback-list.png)](art/feedback-list.png)

### Feedback and Bug-report Forms

[](#feedback-and-bug-report-forms)

Nice modal forms for submitting feedback and bug reports. [![feedback-form.png](art/feedback-form.png)](art/feedback-form.png)[![bug-report-form.png](art/bug-report-form.png)](art/bug-report-form.png)

### Admin Dashboard

[](#admin-dashboard-1)

Comprehensive dashboard for managing all feedback and bug reports. [![admin.png](art/admin.png)](art/admin.png)

Contributing
------------

[](#contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

Support
-------

[](#support)

If you encounter any issues or have questions, please [open an issue](https://github.com/serhiikorniienko/laravel-kuchi/issues) on GitHub.

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance53

Moderate activity, may be stable

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

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

Every ~2 days

Total

3

Last Release

329d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9f328c0182d60b0db1938a93d2dbeace1adb48397d5f2b00bf2a4465d64a2b9f?d=identicon)[serhiikorniienko](/maintainers/serhiikorniienko)

---

Top Contributors

[![SerhiiKorniienko](https://avatars.githubusercontent.com/u/95961352?v=4)](https://github.com/SerhiiKorniienko "SerhiiKorniienko (5 commits)")

---

Tags

laravelpackagelivewirefeedbackbug-report

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/serhiikorniienko-laravel-kuchi/health.svg)

```
[![Health](https://phpackages.com/badges/serhiikorniienko-laravel-kuchi/health.svg)](https://phpackages.com/packages/serhiikorniienko-laravel-kuchi)
```

###  Alternatives

[livewire/volt

An elegantly crafted functional API for Laravel Livewire.

4195.3M84](/packages/livewire-volt)[okipa/laravel-table

Generate tables from Eloquent models.

56752.8k](/packages/okipa-laravel-table)[ramonrietdijk/livewire-tables

Dynamic tables for models with Laravel Livewire

21147.4k](/packages/ramonrietdijk-livewire-tables)[marcorieser/statamic-livewire

A Laravel Livewire integration for Statamic.

2381.5k10](/packages/marcorieser-statamic-livewire)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

116.6k](/packages/tomshaw-electricgrid)[okipa/laravel-form-components

Ready-to-use and customizable form components.

198.0k1](/packages/okipa-laravel-form-components)

PHPackages © 2026

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