Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rdp77/client-management

A beautiful your Client Management with TALL stack application.
https://github.com/rdp77/client-management

client-management filament freelancer laravel management tall-stack

Last synced: 16 days ago
JSON representation

A beautiful your Client Management with TALL stack application.

Awesome Lists containing this project

README

        

# Client Management

Here lives a beautiful starting point to quickly bootstrap your next [TALL stack](https://tallstack.dev/) application
utilizing [Filament](https://filamentphp.com/) for the admin panel.

## Features

- 🧑‍💻 Fully pre-configured and [customized](#plugins-used) Filament panel with best practices in place.
- 🎨 Clean, minimally styled frontend powered by [Livewire](https://livewire.laravel.com/).
- 💄 [TailwindCSS](https://tailwindcss.com/) and [Vite](https://vitejs.dev/) ready for immediate use.
- 👷 Pre-bundled Livewire and [Alpine](https://alpinejs.dev/) for easy extendability.
- ⚡️ SPA-ready in both Filament and the frontend.
- 🔨 GitHub Actions workflows for [Pint](https://github.com/laravel/pint) with pre-configured Dependabot for
dependencies.

## Requirements

Make sure all dependencies have been installed before moving on:

- [PHP](https://secure.php.net/manual/en/install.php) >= 8.1
- [Composer](https://getcomposer.org/download/)
- [Node.js](http://nodejs.org/) >= 18
- [Yarn](https://yarnpkg.com/en/docs/install) or [pnpm](https://pnpm.io/installation)

## Getting Started

Start by creating the project using Composer and configuring the `.env` file:

```sh
composer create-project rdp77/client-management:dev-main
cd client-management
```

After `.env` is configured, you can proceed to migrate & seed the database:

```sh
php artisan migrate:fresh --seed
```

Once the database is seeded, you can login at `/login or /` using the default admin user:

```yaml
Username: admin
Password: admin
```

### Build Assets

The project assets are compiled using Vite. This can be done by installing the dependencies and running the build
command with Yarn.

```sh
yarn install
yarn build
```

or

```sh
pnpm install
pnpm build
```

## Plugins Used

The following [Filament plugins](https://filamentphp.com/plugins) come fully implemented and configured out of the box:

| **Plugin** | **Description** | **Author** |
|:--------------------------------------------------------------------|:---------------------------------------------------------------------------|:------------------------------------------------|
| [Versions](https://github.com/awcodes/filament-versions) | A mostly useless package to display framework versions on Filament panels. | [awcodes](https://github.com/awcodes) |
| [Exceptions](https://github.com/bezhansalleh/filament-exceptions) | A simple but powerful Exception viewer. | [bezhansalleh](https://github.com/bezhansalleh) |
| [Jobs Monitor](https://github.com/croustibat/filament-jobs-monitor) | Easily monitor background jobs and their progress. | [croustibat](https://github.com/croustibat) |
| [Breezy](https://github.com/jeffgreco13/filament-breezy) | Customizable user profile pages and 2FA support. | [jeffgreco13](https://github.com/jeffgreco13) |
| [Logger](https://github.com/z3d0x/filament-logger) | Zero-config resource activity logging. | [z3d0x](https://github.com/z3d0x) |
| [Phone Input](https://github.com/ysfkaya/filament-phone-input) | This package provides a phone input component for Laravel Filament. It uses International Telephone Input to provide a dropdown of countries and flags. | [ysfkaya](https://github.com/ysfkaya/) |
| [Currency](https://github.com/ariaieboy/filament-currency) | This package will add a new currency method to the TextColumn that uses the Filament V2 money formatter. | [ariaieboy](https://github.com/ariaieboy) |

## Bug Reports

If you discover a bug in Filament Starter, please [open an issue](https://github.com/rdp77/client-management/issues).

## Contributing

Contributing whether it be through PRs, reporting an issue, or suggesting an idea is encouraged and appreciated.

## License

Filament Starter is provided under the [MIT License](LICENSE.md).