Skip to content

Commit

Permalink
Initail release
Browse files Browse the repository at this point in the history
  • Loading branch information
Reza Ahmed committed Sep 14, 2024
1 parent 8a5711b commit c719f3a
Show file tree
Hide file tree
Showing 221 changed files with 12,569 additions and 26 deletions.
72 changes: 55 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,55 @@
# AimAdmin - Laravel Admin Panel for Streamlined Development
Welcome to AimAdmin, the ultimate Laravel admin panel plugin engineered to elevate developers' productivity and streamline development workflows. AimAdmin empowers Laravel developers to concentrate exclusively on crafting domain-specific features and functionalities by abstracting away the complexities of building admin UI/UX and common CRUD functionality. With seamless integration and an intuitive interface, AimAdmin accelerates project development without compromising quality or flexibility.
# Key Benefits for Laravel Developers
- **Effortless Integration:** Seamlessly integrate AimAdmin into your Laravel application with minimal setup and configuration overhead.
- **Time-Saving:** Bid farewell to repetitive tasks. Focus your efforts on building core application features while AimAdmin handles administrative tasks efficiently.
- **Customization Made Easy:** Tailor AimAdmin to fit your project requirements effortlessly. Enjoy flexibility for customization without sacrificing simplicity.
- **Robust Functionality:** Explore a comprehensive suite of features, including user management, role-based access control, content management, and more, readily available out of the box.
- **Enhanced Productivity:** Streamline your development process and expedite project delivery with AimAdmin's ready-to-use admin panel solution.
# Get Started
1. Clone the AimAdmin repository.
2. Install dependencies via Composer.
3. Configure your environment variables.
4. Run migrations and seeders.
5. Dive into crafting your application's unique features while AimAdmin handles administrative tasks seamlessly!

# Contributions
Join our vibrant community of developers and contribute to making Laravel development even more efficient and accessible. Whether it's through bug fixes, feature enhancements, or documentation improvements, your contributions to AimAdmin are valued and appreciated.
![Aim-Admin](https://github.com/user-attachments/assets/07112a33-3179-4b49-a625-8fe5b47ad900)

![php-laravel](https://github.com/user-attachments/assets/a146f866-bbfc-4b65-939b-d36fe572227c)
![developed-by-codecoz](https://github.com/user-attachments/assets/041fa195-e167-4b5f-97a7-0d7abf54e26f)

[![Latest Version](https://img.shields.io/packagist/v/codecoz/aim-admin?color=blue&label=release&style=for-the-badge)](https://packagist.org/packages/codecoz/aim-admin)
[![Stars](https://img.shields.io/github/stars/codecoz/aim-admin?color=rgb%2806%20189%20248%29&label=stars&style=for-the-badge)](https://packagist.org/packages/codecoz/aim-admin)
[![Total Downloads](https://img.shields.io/packagist/dt/codecoz/aim-admin.svg?color=rgb%28249%20115%2022%29&style=for-the-badge)](https://packagist.org/packages/codecoz/aim-admin)
[![Forks](https://img.shields.io/github/forks/codecoz/aim-admin?color=rgb%28134%20115%2022%29&style=for-the-badge)](https://packagist.org/packages/codecoz/aim-admin)
[![Issues](https://img.shields.io/github/issues/codecoz/aim-admin?color=rgb%28134%20239%20128%29&style=for-the-badge)](https://packagist.org/packages/codecoz/aim-admin)


# AIM Admin 🎉
<br>
A comprehensive Laravel package designed to simplify admin tasks and develop enterprise web applications. With a robust, flexible, and feature-rich admin dashboard, it promotes best coding practices, following SOLID principles for enhanced code readability, maintainability, and extensibility.

<br>

##
**Boost Laravel Development with Aim Admin**

Aim Admin is a powerful Laravel package designed to simplify admin dashboard development. It empowers you to rapidly build and manage data-driven interfaces with its built-in CRUD generator, eliminating the need for extensive boilerplate code.

**Key Features:**

* **Effortless CRUD Generation:** Generate complete CRUD (Create, Read, Update, Delete) operations for your database models in a single command, saving you time and effort.
##
* **Elegant Admin Interface:** Leverage the popular AdminLTE template for a visually appealing and user-friendly admin dashboard experience.
##
* **Best Coding Practices:** Aim Admin promotes Laravel's best practices and coding standards, ensuring your applications are maintainable and scalable.
##
* **Flexible Customization:** Easily tailor the generated code and interface to perfectly match your specific project requirements.
##
* **Highly Extensible:** Benefit from Laravel's modular architecture to extend Aim Admin's functionality and integrate with other third-party libraries.

##
**Installation:**

```bash
composer require codecoz/aim-admin
```

**Documentation:**

For detailed usage instructions and examples, please refer to the comprehensive documentation: https://codecoz.com/aim-admin

##

**Contributing:**

We welcome contributions from the community! Please feel free to submit bug reports, feature requests, or pull requests.

**License:**

Aim Admin is licensed under the MIT License.
8 changes: 8 additions & 0 deletions changelog.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Changelog

All notable changes to `Admin` will be documented in this file.

## Version 1.0

### Added
- Everything
48 changes: 48 additions & 0 deletions composer.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
{
"name": "codecoz/aim-admin",
"description": "Welcome to AimAdmin, the ultimate Laravel admin panel plugin engineered to elevate developers' productivity and streamline development workflows.",
"license": "MIT",
"minimum-stability": "stable",
"authors": [
{
"name": "CodeCoz",
"email": "contact@codecoz.com",
"homepage": "https://codecoz.com"
}
],
"homepage": "https://codecoz.com",
"keywords": [
"Laravel",
"Aim",
"Admin"
],
"require": {
"php": "^8.1",
"illuminate/support": "~10|~11"
},
"require-dev": {
"orchestra/testbench": "~9",
"gajus/dindent": "^2.0",
"phpunit/phpunit": "^10.0"
},
"autoload": {
"psr-4": {
"CodeCoz\\AimAdmin\\": "src/"
}
},
"autoload-dev": {
"psr-4": {
"CodeCoz\\AimAdmin\\Tests\\": "tests/"
}
},
"extra": {
"laravel": {
"providers": [
"CodeCoz\\AimAdmin\\AdminServiceProvider"
],
"aliases": {
"Admin": "CodeCoz\\AimAdmin\\Facades\\Admin"
}
}
}
}
106 changes: 106 additions & 0 deletions config/aim-admin.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,106 @@
<?php

return [
/* --------------------------------------------------------------------------------------------
* Menu Configuration
* --------------------------------------------------------------------------------------------
*/
'menu_filters' => [
CodeCoz\AimAdmin\MenuBuilder\Filters\HrefFilter::class,
CodeCoz\AimAdmin\MenuBuilder\Filters\ActiveFilter::class,
CodeCoz\AimAdmin\MenuBuilder\Filters\ClassesFilter::class,
],

'menu' => [
// Navbar items:
[
'text' => 'Dashboard',
'icon' => 'ti ti-home',
'url' => 'dashboard'
],

[
'text' => 'Support 1',
'url' => '#',
'icon' => 'ti ti-help',
'active' => ['support1'],
'submenu' => [
[
'text' => 'Ticket',
'url' => 'support1',
'icon' => 'ti ti-article',
]
],
],

[
'text' => 'Support 2',
'url' => '#',
'icon' => 'ti ti-help',
'active' => ['support2'],
'submenu' => [
[
'text' => 'Ticket',
'url' => 'support2',
'icon' => 'ti ti-article',
]
],
],

[
'text' => 'Support 3',
'url' => '#',
'icon' => 'ti ti-help',
'active' => ['support3'],
'submenu' => [
[
'text' => 'Ticket',
'url' => 'support3',
'icon' => 'ti ti-article',
]
],
],

],

/* --------------------------------------------------------------------------------------------
* File Upload Configuration
* --------------------------------------------------------------------------------------------
*/
'upload_file_type' => ['png', 'jpg', 'bmp', 'pdf', 'doc', 'xls', 'ppt'],
'upload_file_size' => 5 * 1024,

/* --------------------------------------------------------------------------------------------
* Auth Configuration
* --------------------------------------------------------------------------------------------
*/
'auth' => [
'controller' => \CodeCoz\AimAdmin\Http\Controllers\Auth\LoginController::class,
'user_model' => \App\Models\User::class,
'url' => 'login',
'logout_url' => 'logout',
'profile_url' => 'profile',
'middleware' => ['guest', 'web'],
],
'registration' => [
'controller' => \CodeCoz\AimAdmin\Http\Controllers\Auth\RegistrationController::class,
'fields' => [
'number' => 'id',
'text' => 'full_name'
]
],
'back_to_top' => true,
'layout_class' => [
'body' => 'text-sm',
'brand' => '',
'sidebar' => '',
'navbar' => '',
'footer' => '',
],
'footer_text' => 'Anything you want',
//Toast Time
'flash-timer' => 2000,
'show_toast_error' => true,
'show_inline_alert_box' => true,
'inline_validation_error' => true
];
27 changes: 27 additions & 0 deletions contributing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# Contributing

Contributions are welcome and will be fully credited.

Contributions are accepted via Pull Requests on [Github](https://github.com/codecoz/aim-admin).

# Things you could do
If you want to contribute but do not know where to start, this list provides some starting points.
- Add license text
- Remove rewriteRules.php
- Set up TravisCI, StyleCI, ScrutinizerCI
- Write a comprehensive ReadMe

## Pull Requests

- **Add tests!** - Your patch won't be accepted if it doesn't have tests.

- **Document any change in behaviour** - Make sure the `readme.md` and any other relevant documentation are kept up-to-date.

- **Consider our release cycle** - We try to follow [SemVer v2.0.0](http://semver.org/). Randomly breaking public APIs is not an option.

- **One pull request per feature** - If you want to do more than one thing, send multiple pull requests.

- **Send coherent history** - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please [squash them](http://www.git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Changing-Multiple-Commit-Messages) before submitting.


**Happy coding**!
49 changes: 49 additions & 0 deletions database/migrations/0001_01_01_000000_create_users_table.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
/**
* Run the migrations.
*/
public function up(): void
{
Schema::create('users', function (Blueprint $table) {
$table->id();
$table->string('name');
$table->string('email')->unique();
$table->timestamp('email_verified_at')->nullable();
$table->string('password');
$table->rememberToken();
$table->timestamps();
});

Schema::create('password_reset_tokens', function (Blueprint $table) {
$table->string('email')->primary();
$table->string('token');
$table->timestamp('created_at')->nullable();
});

Schema::create('sessions', function (Blueprint $table) {
$table->string('id')->primary();
$table->foreignId('user_id')->nullable()->index();
$table->string('ip_address', 45)->nullable();
$table->text('user_agent')->nullable();
$table->longText('payload');
$table->integer('last_activity')->index();
});
}

/**
* Reverse the migrations.
*/
public function down(): void
{
Schema::dropIfExists('users');
Schema::dropIfExists('password_reset_tokens');
Schema::dropIfExists('sessions');
}
};
Empty file removed docs/contents/form.md
Empty file.
9 changes: 0 additions & 9 deletions docs/index.md

This file was deleted.

5 changes: 5 additions & 0 deletions license.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# The license

Copyright (c) Md Abdullah Ibne Masud <contact@codecoz.com>

...Add your license text here...
14 changes: 14 additions & 0 deletions phpunit.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<?xml version="1.0" encoding="UTF-8"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" bootstrap="vendor/autoload.php" backupGlobals="false" colors="true" processIsolation="false" stopOnFailure="false" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd" cacheDirectory=".phpunit.cache" backupStaticProperties="false">
<testsuites>
<testsuite name="Package">
<directory suffix=".php">./tests/Components</directory>
<directory suffix=".php">./tests/Service</directory>
</testsuite>
</testsuites>
<source>
<include>
<directory>src/</directory>
</include>
</source>
</phpunit>
15 changes: 15 additions & 0 deletions resources/css/modules/backtotop.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
.back-to-top {
transition: opacity 0.5s ease-out, visibility 0.5s;
opacity: 0;
visibility: hidden;
}

.back-to-top.show {
opacity: 1;
visibility: visible;
}

.back-to-top:hover {
transform: scale(1.1);
transition: transform 0.3s ease-in-out;
}
File renamed without changes.
Binary file not shown.
Binary file not shown.
Binary file not shown.
File renamed without changes.
Binary file added resources/img/loader.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/img/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
33 changes: 33 additions & 0 deletions resources/js/adminlte.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
import 'admin-lte/dist/js/adminlte'
import 'admin-lte/plugins/bootstrap/js/bootstrap.bundle'

// fontawesome
import "./modules/fontawesome";

// ChartJs
import "./modules/chartjs";

// Select2
import "./modules/sweetalert2";

//Date-rangePicker
import "./modules/daterangepicker";

//Date Picker
import "./modules/flatpickr";

// Select 2
import "./modules/select2";

//Button Loader
import "./modules/buttonloader";

//Modal Loader
import "./modules/modal";

//Ajax request
import "./modules/ajaxrequest";

//Back to Top
import "./modules/backtotop";

Loading

0 comments on commit c719f3a

Please sign in to comment.