PHPackages                             clippings/composer-init - 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 & Helpers](/categories/utility)
4. /
5. clippings/composer-init

AbandonedArchivedApplication[Utility & Helpers](/categories/utility)

clippings/composer-init
=======================

Initialize a composer package based on a template package

0.4.0(10y ago)3131[1 issues](https://github.com/clippings/composer-init/issues)BSD-3-ClausePHP

Since Mar 25Pushed 10y agoCompare

[ Source](https://github.com/clippings/composer-init)[ Packagist](https://packagist.org/packages/clippings/composer-init)[ RSS](/packages/clippings-composer-init/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (10)Dependencies (2)Versions (13)Used By (0)

Composer Init
=============

[](#composer-init)

[![Build Status](https://camo.githubusercontent.com/75965f92a1d8f6a2ef84536c4a93361ad76e94751c6dc7448dbf4b5eb8ea7e95/68747470733a2f2f7472617669732d63692e6f72672f636c697070696e67732f636f6d706f7365722d696e69742e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/clippings/composer-init)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/da634618b272da81e115052c1622d342dd89373c3356a0707e10e16c628047d8/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f636c697070696e67732f636f6d706f7365722d696e69742f6261646765732f7175616c6974792d73636f72652e706e673f733d61313430343637346636386334383934643635313135306361663439383561613539353937353135)](https://scrutinizer-ci.com/g/clippings/composer-init/)[![Code Coverage](https://camo.githubusercontent.com/57778c3881ab899ddd3560d4c5fd82da6b76a1b8a7cb80f239832148cbf0405b/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f636c697070696e67732f636f6d706f7365722d696e69742f6261646765732f636f7665726167652e706e673f733d33643566623535633432633638383736373939313533323036353862353433656439333565303061)](https://scrutinizer-ci.com/g/clippings/composer-init/)[![Latest Stable Version](https://camo.githubusercontent.com/372789631abe74a65f55a310c7f9d4f0f1572fd8abbd20d393495e7471a1a760/68747470733a2f2f706f7365722e707567782e6f72672f636c697070696e67732f636f6d706f7365722d696e69742f762f737461626c652e706e67)](https://packagist.org/packages/clippings/composer-init)

Tired of creating the same directory structure every time you start a new project? Tired of constantly modifying files if you clone github template repo? This command line tool allows you to initialize a project based on a template, and fills in values in the template.

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

[](#installation)

Install via composer

```
$ composer global require clippings/composer-init

```

This will install it to your user's global composer. If you already have ~/.composer/vendor/bin/ in your PATH you can start using it with

```
$ composer-init

```

otherwise you can do it by calling directly

```
$ ~/.composer/vendor/bin/composer-init

```

Basic Usage
-----------

[](#basic-usage)

- `composer-init search` to discover templates
- `composer-init use {template-package}` in an empty folder to use a template
- `composer-init token {token}` set a github token for downloading past the [github rate limit](https://developer.github.com/v3/rate_limit/)

`composer-init` Gets a lot of defaults from github repo & organization, so it is best to create an empty repo in github, clone it locally and run "composer-init use ..." there.

Creating Templates
------------------

[](#creating-templates)

A composer-init template must be published to Packagist.org, (therefore have a composer.json file) and have a prompts.json file to describe which of the available prompts will be used. The package should be published as "type": "composer-init-template". All the code for the template is present in the "root" directory.

example composer.json file:

```
{
    "name": "clippings/package-template",
    "description": "Package Template",
    "license": "MIT",
    "type": "composer-init-template",
    "authors": [
        {
            "name": "John Smith",
            "email": "john@example.com",
            "role": "Author"
        }
    ]
}
```

example prompts.json file:

```
[
    "package_name",
    "title",
    "description",
    "php_namespace",
    "author_name",
    "author_email",
    "copyright",
    "bugs"
]
```

This states that this package will use these prompts, gather their input and then fill in the placeholders inside all the files in the root folder.

Here's an example template:

Prompts
-------

[](#prompts)

All prompts try to guess a reasonable default, but ask the user to confirm/correct its value.

#### author\_email

[](#author_email)

The email of the author, by default uses `git config user.email`. You can set it yourself with `git config user.email {my email}` or globally with `git config --global user.email {my email}`. As stated in [first time git setup](https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup) guide

Adds `{% author_email %}` template variable

#### author\_name

[](#author_name)

The name of the author, by default uses `git config user.name`. You can set it yourself with `git config user.name {my name}` or globally with `git config --global user.name {my name}`. As stated in [first time git setup](https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup) guide

Adds `{% author_name %}` template variable

#### bugs

[](#bugs)

The url for submitting new issues. By default gets the repo's gitub issues url. e.g. `https://github.com/clippings/composer-init/issues`

Adds `{% bugs %}` template variable

#### copyright

[](#copyright)

Tries to guess the copyright holder by going through

- github organization
- github user
- git user
- file owner

And exposes it as "{year}, {copyright\_entity}" - where year is the current year and copyright\_entity is the guessed value. You can also get to the `copyright_entity` value separately

Adds `{% copyright %}` template variable
Adds `{% copyright_entity %}` template variable

#### description

[](#description)

The description of the github repo.

Adds `{% description %}` template variable

#### package\_name

[](#package_name)

The github package name e.g. `clippings/composer-init`

Adds `{% package_name %}` template variable

#### php\_namespace

[](#php_namespace)

Tires to guess the package name, using github's organization/username and repo name. So `clippings/composer-init` would be converted to `Clippings\ComposerInit`. It also tries to guess the name with initials, so in this case it would also give the option of `CL\ComposerInit`. These can be cycled with tab completion or auto-completed when entering

Adds `{% php_namespace %}`
Adds `{% php_namespace_escaped %}` template variable where all "\\" characters are converted to "\\\\"

#### slack\_notification

[](#slack_notification)

Get a "secure slack notification token". basically asks for a value and returns "slack:\\n secure: {value}\\n", so you can easily add slack to your .travis.yml notifications

#### title

[](#title)

The title of the github repo.

Adds `{% title %}` template variable

Credits
-------

[](#credits)

Inspired by [grunt-init](https://github.com/gruntjs/grunt-init)

Copyright (c) 2014-2015, Clippings Ltd. Developed by [Ivan Kerin](https://github.com/ivank) as part of [clippings.com](http://clippings.com)

Under BSD-3-Clause license, read LICENSE file.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance13

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 94.2% 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 ~55 days

Total

12

Last Release

3821d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/506129?v=4)[Harry Dobrev](/maintainers/hkdobrev)[@hkdobrev](https://github.com/hkdobrev)

![](https://avatars.githubusercontent.com/u/4113307?v=4)[Danail Kyosev](/maintainers/dkyosev)[@dkyosev](https://github.com/dkyosev)

![](https://avatars.githubusercontent.com/u/7592650?v=4)[Evstati Zarkov](/maintainers/EZarkov)[@EZarkov](https://github.com/EZarkov)

![](https://avatars.githubusercontent.com/u/745771?v=4)[Filip Georgiev](/maintainers/phgeorgiev)[@phgeorgiev](https://github.com/phgeorgiev)

![](https://avatars.githubusercontent.com/u/490439?v=4)[Zdravko Evstatiev](/maintainers/zedevs)[@zedevs](https://github.com/zedevs)

---

Top Contributors

[![ivank](https://avatars.githubusercontent.com/u/4976?v=4)](https://github.com/ivank "ivank (49 commits)")[![hkdobrev](https://avatars.githubusercontent.com/u/506129?v=4)](https://github.com/hkdobrev "hkdobrev (3 commits)")

### Embed Badge

![Health badge](/badges/clippings-composer-init/health.svg)

```
[![Health](https://phpackages.com/badges/clippings-composer-init/health.svg)](https://phpackages.com/packages/clippings-composer-init)
```

###  Alternatives

[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[glhd/conveyor-belt

14797.0k](/packages/glhd-conveyor-belt)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[php-soap/wsdl

Deals with WSDLs

173.5M12](/packages/php-soap-wsdl)[ralphjsmit/laravel-helpers

A package containing handy helpers for your Laravel-application.

13704.6k2](/packages/ralphjsmit-laravel-helpers)

PHPackages © 2026

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