PHPackages                             cecil/links - 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. cecil/links

ActiveProject

cecil/links
===========

Links is a Linktree alternative powered by Cecil, Tailwind CSS and Font Awesome.

4.4.1(6mo ago)17801MITCSS

Since Dec 5Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/Cecilapp/Links)[ Packagist](https://packagist.org/packages/cecil/links)[ GitHub Sponsors](https://github.com/ArnaudLigny)[ Fund](https://opencollective.com/cecil)[ RSS](/packages/cecil-links/feed)WikiDiscussions main Synced 1mo ago

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

*Links* is an open source Linktree alternative powered by [Cecil](https://cecil.app), [Tailwind CSS](https://tailwindcss.com) and [Font Awesome](https://fontawesome.com).

[![Links website](docs/screenshot.png)](https://links.cecil.app)

Demo:

Install
-------

[](#install)

Important

PHP 8.1 and [Composer](https://getcomposer.org) are required.

The easiest way to create a new Links project is using Composer:

```
composer create-project cecil/links --ask
```

Usage
-----

[](#usage)

### Preview

[](#preview)

You can easily preview your site locally with the following command:

```
php cecil.phar serve --open
```

Tip

The option `--open` automatically open your site in the default web browser.

### Configuration

[](#configuration)

Define site configuration and social identities in [`cecil.yml`](cecil.yml):

```
title:
baseurl:
baseline: "" # optional, recommended
description: "" # optional, recommended
author: # used by metatags, optional
  name:
  url:
  email:  # used in social identities block, optional
social: # social identities
  : # github, linkedin, instagram, youtube, mastodon, bluesky, threads, twitter or x
    url:
avatar: avatar.png
image: avatar.png # Open Graph image, optional, recommended
manifest:
  background_color: "#fff" # PWA background color
  theme_color: "#0369a1"   # theme color
serviceworker:
  enabled: false           # turns on PWA
# buttons color
links:
  buttons:
    color: page # page or css ('page' by default)
```

Tip

The exhaustive [Cecil](https://cecil/app) documentation is available at [cecil.app](https://cecil.app/documentation/configuration/).

### Manage page

[](#manage-page)

From `pages/index.md` file you can:

1. change page structure with *blocks* array in *front matter*
2. add links in *front matter*
3. add rich content authoring in Markdown in page *body* (optional)

```
---
blocks:
  - name: content # page content
  - name: links   # page links
  - name: social  # social identities
links:
  - title:
    url:
    color: "" # hexadecimal color code, optional (e.g. "#1DA1F2")
    icon: : # Font Awesome icon (https://fontawesome.com/icons), optional (e.g. "brands:github")
---
Content here.
```

Publish
-------

[](#publish)

Run the following command:

```
php cecil.phar build
```

Then just deploy the content of \_*site* directory to your web hosting solution.

Customize
---------

[](#customize)

### Buttons color

[](#buttons-color)

You can disable page's buttons color and use CSS color instead:

*cecil.yml:*

```
links:
  buttons:
    color: css
```

### CSS theme

[](#css-theme)

You can customize theme through the file `./assets/tailwind.css`, then rebuild CSS:

```
npm run css:build
```

> [Tailwind CSS](https://tailwindcss.com) is required.

Update
------

[](#update)

If you want to update the [*links*](https://github.com/Cecilapp/theme-links#readme) theme and *component themes* (i.e.: [*fontawesome*](https://github.com/Cecilapp/theme-fontawesome#readme), [*pwa*](https://github.com/Cecilapp/theme-pwa#readme) and [*netlity*](https://github.com/Cecilapp/theme-netlify#readme)) you must run the following command:

```
composer update
```

License
-------

[](#license)

*Links* is a free software distributed under the terms of the MIT license.

© [Arnaud Ligny](https://arnaudligny.fr)

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance76

Regular maintenance activity

Popularity18

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 99.5% 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 ~15 days

Recently: every ~7 days

Total

49

Last Release

180d ago

Major Versions

1.0.0 → 2.0.12024-02-06

2.5.3 → 3.0.02024-12-12

3.5.2 → 4.0.02025-09-30

### Community

Maintainers

![](https://www.gravatar.com/avatar/52a734f97ce4ef72fb07b59e5d0f7f6a26a0b322da49b881bedc3896c5e7f128?d=identicon)[aligny](/maintainers/aligny)

---

Top Contributors

[![ArnaudLigny](https://avatars.githubusercontent.com/u/80580?v=4)](https://github.com/ArnaudLigny "ArnaudLigny (184 commits)")[![welcoMattic](https://avatars.githubusercontent.com/u/773875?v=4)](https://github.com/welcoMattic "welcoMattic (1 commits)")

---

Tags

cecilcecil-starterstatic-sitetailwindcss

### Embed Badge

![Health badge](/badges/cecil-links/health.svg)

```
[![Health](https://phpackages.com/badges/cecil-links/health.svg)](https://phpackages.com/packages/cecil-links)
```

PHPackages © 2026

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