PHPackages                             islamwalied/one-click-project - 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. islamwalied/one-click-project

ActiveLibrary

islamwalied/one-click-project
=============================

A Laravel package to generate complete project structure with repository pattern

1.1.4(1y ago)2126MITPHPPHP ^8.0

Since Mar 8Pushed 1y ago1 watchersCompare

[ Source](https://github.com/islamWalied/OneClickProject)[ Packagist](https://packagist.org/packages/islamwalied/one-click-project)[ RSS](/packages/islamwalied-one-click-project/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (9)Used By (0)

One Click Project
=================

[](#one-click-project)

**One Click Project** is a powerful Laravel package designed to streamline your development process by generating a complete project structure with a single Artisan command. It creates a model, migration, repository (with a base repository pattern), service layer, resource, controller, request classes, and API routes—all tailored to your specifications.

Features
--------

[](#features)

- **Automated Scaffolding**: Generate a full CRUD-ready structure for your Laravel project in minutes.
- **Repository Pattern**: Implements a base repository with interfaces and implementations for clean, reusable data access logic.
- **Service Layer**: Includes a service layer with dependency injection for business logic separation.
- **API Ready**: Generates API routes with middleware support (e.g., Sanctum authentication, CORS).
- **Customizable**: Allows you to define model attributes and custom repository methods interactively.
- **Image Handling**: Built-in support for image uploads, updates, and deletions via a reusable `ImageTrait`.
- **Response Helpers**: Standardized JSON responses via `ResponseTrait` for consistent API output.
- **Route Helper**: Includes a `RouteHelper` utility for dynamically including API route files.
- **Enhanced Attribute Management**: Improved attribute collection with support for modifiers like nullable, unique, and default values.
- **Enum Support**: Add enum columns with specific allowed values in migrations.
- **Middleware Configuration**: Selectively apply authentication middleware to specific API routes.
- **Comprehensive Validation**: Auto-generated validation rules based on attribute types.
- **Relationship Generation**: Automatic belongsTo relationships for foreign keys.
- **Flexible Route Authentication**: Configure which API endpoints require authentication.

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

[](#installation)

You can install the package via Composer:

```
composer require islamwalied/one-click-project
```

The package will automatically register its service provider and command thanks to Laravel's auto-discovery feature.

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

[](#requirements)

- PHP 8.0 or higher
- Laravel 10.x or 11.x
- Composer
- GD Library extension for PHP (`ext-gd`)

### Updating Composer Configuration

[](#updating-composer-configuration)

Add the GD extension requirement to your `composer.json`:

```
"require": {
    "ext-gd": "*"
}
```

Usage
-----

[](#usage)

Run the Artisan command to generate your project structure:

```
php artisan generate:project {ModelName}
```

Replace `{ModelName}` with the name of your model (e.g., `User`, `Post`).

### Example

[](#example)

```
php artisan generate:project Post
```

#### Interactive Prompts

[](#interactive-prompts)

1. **Model Attributes**: You'll be asked to specify column names and types (e.g., `string`, `integer`, `foreignId`) for the model's migration and fillable properties.
    - Example: ```
        Enter column name (or "done" to finish): title
        Select column type: string
        Select modifiers for 'title' (multiple choice, comma-separated, press Enter for none): nullable, unique
        Enter column name (or "done" to finish): status
        Select column type: enum
        Enter allowed values for 'status' (comma-separated, e.g., active,inactive): published,draft,archived
        Enter column name (or "done" to finish): user_id
        Select column type: foreignId
        Enter column name (or "done" to finish): done

        ```
2. **Custom Methods**: Optionally add custom methods to the repository and service layers.
    - Example: ```
        Do you want to add a custom method in the repository? (yes/no): yes
        Enter method name (e.g., findByEmail): findBySlug
        Enter return type (default: mixed): string
        Enter parameters (e.g., string $email, int $id): string $slug
        Do you want to implement this method in the service? (yes/no): yes

        ```
3. **Route Authentication**: Specify which API endpoints require authentication:
    - Example: ```
        Specify which methods should require authentication (auth:sanctum):
        > store - POST create a resource
        > update - PATCH update a resource
        > destroy - DELETE delete a resource

        ```

#### Generated Structure

[](#generated-structure)

After running the command, you'll get:

- `app/Models/Post.php` (Model with fillable attributes and relationships)
- `database/migrations/...create_posts_table.php` (Migration with specified columns)
- `app/Repositories/Interfaces/PostRepository.php` & `app/Repositories/Implementation/PostRepositoryImpl.php` (Repository layer)
- `app/Services/Interfaces/PostService.php` & `app/Services/Implementation/PostServiceImpl.php` (Service layer)
- `app/Http/Resources/PostResource.php` (API resource)
- `app/Http/Controllers/PostController.php` (Controller with dependency injection)
- `app/Http/Requests/StorePostRequest.php` & `UpdatePostRequest.php` (Form request validation)
- `routes/api/post.php` (API routes)

#### **Verified Publishing Section**:

[](#verified-publishing-section)

- To Publish The Required Files To Use All Features You Must Use Those Commands After Installing:
    - `php artisan vendor:publish --provider="IslamWalied\OneClickProject\OneClickProjectServiceProvider" --tag="helpers"`
    - `php artisan vendor:publish --provider="IslamWalied\OneClickProject\OneClickProjectServiceProvider" --tag="traits"`
    - `php artisan vendor:publish --provider="IslamWalied\OneClickProject\OneClickProjectServiceProvider" --tag="middleware"`
    - `php artisan vendor:publish --provider="IslamWalied\OneClickProject\OneClickProjectServiceProvider" --tag="logging"`

#### Post-Generation Steps

[](#post-generation-steps)

1. **Register Service Providers**: If not already registered, add `RepositoryServiceProvider` and `ServiceServiceProvider` to `bootstrap/app.php` (Laravel 10+): ```
    ->withProviders([
        App\Providers\RepositoryServiceProvider::class,
        App\Providers\ServiceServiceProvider::class,
    ])
    ```
2. **Run Migrations**: Apply the generated migration: ```
    php artisan migrate
    ```
3. **Test the API**: Use tools like Postman to test the generated endpoints (e.g., `GET /api/v1/posts`).

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

[](#configuration)

No additional configuration is required out of the box. However, you can customize the generated files by modifying the package's generator classes if needed.

### Customizing Image Storage

[](#customizing-image-storage)

The `ImageTrait` uses Laravel's `public` disk by default. To change this, update your `filesystems.php` config or extend the trait in your application.

### Customizing Logging

[](#customizing-logging)

After publishing the logging files, you need to update your `config/logging.php` file to include the custom daily logger. To use it add this object to the end of the file:

```
'daily_by_date' => [
    'driver' => 'custom',
    'via' => App\Logging\LogHandler::class,
    'level' => 'error',
],
```

API Endpoints
-------------

[](#api-endpoints)

Generated routes follow this pattern:

- `GET /v1/{model}s` - List all resources
- `GET /v1/{model}s/{id}` - Show a resource
- `POST /v1/{model}s` - Create a resource
- `PATCH /v1/{model}s/{id}` - Update a resource
- `DELETE /v1/{model}s/{id}` - Delete a resource

All routes are prefixed with `v1/` and include `cors`, `lang`, and `throttle` middleware by default. You can selectively apply the `auth:sanctum` middleware to specific endpoints during the generation process.

Advanced Features
-----------------

[](#advanced-features)

### Model Attribute Modifiers

[](#model-attribute-modifiers)

When creating columns, you can apply the following modifiers:

- `nullable`: Makes the column accept NULL values
- `unique`: Ensures values in the column are unique
- `default`: Sets a default value for the column

### Enum Support

[](#enum-support)

For enum columns, you can specify allowed values as a comma-separated list. The migration will be generated with these values properly configured.

### Foreign Key Relationships

[](#foreign-key-relationships)

When adding a `foreignId` column, the system will:

- Create a properly constrained foreign key in the migration
- Add a `belongsTo` relationship in the model
- Set up appropriate validation rules in request classes

### Service-Repository Architecture

[](#service-repository-architecture)

The generated code follows a clean service-repository pattern:

- Controllers interact only with services
- Services contain business logic and interact with repositories
- Repositories handle data access and storage
- All components are properly bound using dependency injection

Notes
-----

[](#notes)

- **RouteHelper Dependency**: The package assumes a `RouteHelper` class exists to include API route files dynamically. If your project doesn't have this, you'll need to manually include the generated route files in `routes/api.php` or implement a custom `RouteHelper`.
- **Localization**: The package uses Laravel's `__()` helper for messages (e.g., `messages.post.index_success`). Define these in your `lang` files for full support.

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

[](#contributing)

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a feature branch (`git checkout -b feature/your-feature`).
3. Commit your changes (`git commit -m "Add your feature"`).
4. Push to the branch (`git push origin feature/your-feature`).
5. Open a Pull Request.

Issues
------

[](#issues)

If you encounter any issues or have suggestions, please [open an issue](https://github.com/islamwalied/oneClickProject/issues) on GitHub.

License
-------

[](#license)

This package is open-sourced under the [MIT License](LICENSE).

Credits
-------

[](#credits)

Developed by [Islam Walied](mailto:islam.walied96@gmail.com). Special thanks to the Laravel community for inspiration and support.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance48

Moderate activity, may be stable

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity47

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 ~1 days

Total

8

Last Release

417d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/56414faaa0bf6764946a886dc83d906e28a4ad55cf07fb93ceb9ee75ff63419b?d=identicon)[islamWalied](/maintainers/islamWalied)

---

Top Contributors

[![islamWalied](https://avatars.githubusercontent.com/u/96248477?v=4)](https://github.com/islamWalied "islamWalied (10 commits)")

### Embed Badge

![Health badge](/badges/islamwalied-one-click-project/health.svg)

```
[![Health](https://phpackages.com/badges/islamwalied-one-click-project/health.svg)](https://phpackages.com/packages/islamwalied-one-click-project)
```

###  Alternatives

[anourvalar/eloquent-serialize

Laravel Query Builder (Eloquent) serialization

11320.2M21](/packages/anourvalar-eloquent-serialize)[namu/wirechat

A Laravel Livewire messaging app for teams with private chats and group conversations.

54324.5k](/packages/namu-wirechat)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135192.6k5](/packages/statamic-rad-pack-runway)

PHPackages © 2026

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