PHPackages                             arkecosystem/foundation - 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. arkecosystem/foundation

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

arkecosystem/foundation
=======================

User-Interface Scaffolding for Laravel. Powered by Tailwind CSS.

19.18.0(1mo ago)1116.4k↓10.4%2[2 PRs](https://github.com/ArkEcosystem/laravel-foundation/pulls)MITPHPPHP ^8.4CI failing

Since Sep 30Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/ArkEcosystem/laravel-foundation)[ Packagist](https://packagist.org/packages/arkecosystem/foundation)[ RSS](/packages/arkecosystem-foundation/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (78)Versions (544)Used By (0)

Laravel Foundation
==================

[](#laravel-foundation)

 [![](/banner.png)](/banner.png)

> Scaffolding for Laravel. Powered by Tailwind CSS and Livewire.

[List of the available components](https://github.com/ArkEcosystem/laravel-foundation/usage/ui.md#available-components)

Prerequisites
-------------

[](#prerequisites)

Since this package relies on a few 3rd party packages, you will need to have the following installed and configured in your project:

- [Alpine.js](https://alpinejs.dev)
- [Tailwind CSS](https://tailwindcss.com)
- [Tailwind UI](https://tailwindui.com)
- [Livewire](https://laravel-livewire.com)

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

[](#installation)

Require with composer: `composer require arkecosystem/foundation`

Usage
-----

[](#usage)

- [CommonMark](/usage/commonmark.md)
- [Documentation](/usage/documentation.md)
- [Hermes](/usage/hermes.md)
- [Stan](/usage/stan.md)
- [UI](/usage/ui.md)
- [Telescope](/usage/telescope.md)

Examples
--------

[](#examples)

- [CommonMark](/examples/commonmark.md)
- [Hermes](/examples/hermes.md)
- [UI](/examples/ui.md)

Composer Scripts
----------------

[](#composer-scripts)

Add those scripts to `composer.json`

```
"scripts": [
    "analyse": [
        "vendor/bin/phpstan analyse --configuration=vendor/arkecosystem/foundation/phpstan.neon --memory-limit=2G"
    ],
    "format": [
        "vendor/bin/php-cs-fixer fix --config=vendor/arkecosystem/foundation/.php-cs-fixer.php"
    ],
    "refactor": [
        "./vendor/bin/rector process --config=vendor/arkecosystem/foundation/rector.php"
    ],
    "test": [
        "./vendor/bin/pest"
    ],
    "test:fast": [
        "./vendor/bin/pest --parallel"
    ],
    "test:coverage": [
        "./vendor/bin/pest --coverage --min=100 --coverage-html=.coverage --coverage-clover=coverage.xml"
    ]
],
```

Working on Components Locally
-----------------------------

[](#working-on-components-locally)

This package contains a lot of frontend components, but no frontend views itself. So when you need to work on it, you rely on the frontend from another project. Usually this can be done by having composer symlink this package, but in this case there is a second step required to ensure you can run `yarn watch`, `yarn prod` etc.

I'll get into it in detail and will use the marketsquare.io project as an example. Let's assume that both the marketsquare.io and laravel-foundation git repo's are installed in the `/Users/my-user/projects/` folder on our local development machine.

### Step 1 - Composer Symlink

[](#step-1---composer-symlink)

In the `composer.json` file from marketsquare.io under "repositories" add the laravel-foundation as a path:

```
"repositories": [
    {
        "type": "path",
        "url": "../laravel-foundation"
    }
]
```

After that run `composer require arkecosystem/foundation --ignore-platform-reqs -W`. The laravel-foundation package is now symlinked and you can work in your IDE from within your `laravel-foundation` repo.

### Step 2 - Symlink node\_modules

[](#step-2---symlink-node_modules)

If you would run `yarn watch` from within your marketsquare.io repo you'll get a lot of errors because dependencies are not smart enough to know they're in a symlinked directory.

- Delete the `node_modules` directory on `laravel-foundation`.
- Symlink the `node_modules` directory from marketsquare.io to laravel-foundation by running `ln -s /Users/my-user/projects/marketsquare.io/node_modules node_modules` (from within your laravel-foundation repo).

Now, when you go back to your marketsquare.io repo, you can run `yarn watch`.

Don't forget to remove the symlinking after you're done.

### Turn those steps into scripts

[](#turn-those-steps-into-scripts)

> ***Keep in mind***:
>
> these scripts are written for Mac users. If you use another OS you may need to tweak them accordingly.
>
> `unlink:foundation` uses `git` commands to restore the current project.

To improve your workflow you can turn those steps into scripts and use them directly in your command line, like:

```
$ link:foundation
$ unlink:foundation
```

You can copy/paste them in your `.bashrc`, `.aliases` or whatever file you set up to manage your aliases.

Before jumping into the code, let me explain what you can do with them ([skip to code](/#code)).

For these examples we use `marketsquare.io` and `laravel-foundation` repos, assuming that both are installed in the same folder (`/Users/my-user/projects`) on our local development machine.

#### symlink your current project to laravel-foundation

[](#symlink-your-current-project-to-laravel-foundation)

```
# move into marketsquare.io folder
$ cd /Users/my-user/projects/marketsquare.io

# symlink to laravel-foundation repo
$ link:foundation
```

That's it!

The script automatically tries to guess where the `laravel-foundation` repo is located and symlinks the current project to it (in this case `marketsquare.io`).

If the current project and `laravel-foundation` repos are not in the same folder, the script tries to move one level back (`../../`) and tries again. If `laravel-foundation` is not found, the script exits and outputs an error message.

You can always specify a custom path, by passing it as an argument

```
$ link:foundation 'Users/john/repos/laravel-foundation'
```

#### remove symlink from your current project

[](#remove-symlink-from-your-current-project)

```
# move into marketsquare.io folder
$ cd /Users/my-user/projects/marketsquare.io

# remove symlink
$ unlink:foundation
```

Again, that's it!

The script looks for `.symlink_foundation` temp file (created by `link:foundation`), that contains the symlinked path. If not found, it tries to guess where the `laravel-foundation` repo is located and removes the symlink from the current project (in this case `marketsquare.io`).

If the current project and `laravel-foundation` repos are not in the same folder, the script tries to move one level back (`../../`) and tries again. If `laravel-foundation` is not found, the script exits and outputs an error message.

You can always specify a custom path, by passing it as an argument

```
$ unlink:foundation 'Users/john/repos/laravel-foundation'
```

#### code

[](#code)

Scripts are self-explanatory, plus they have comments on each line 😉.

```
function link:foundation() {

    # Check if already symlinked
    [ -f .symlink_foundation ] && { echo "already symlinked"; return; }

    # Get path from args or guess it
    if [ "$1" != "" ]; then
        FOUNDATION="$1"
    elif [ -d ../laravel-foundation ]; then
        FOUNDATION="../laravel-foundation"
    elif [ -d ../../laravel-foundation ]; then
        FOUNDATION="../../laravel-foundation"
    else
        echo "Unable to find `laravel-foundation`"
        return
    fi

    # Generate random string
    RANDOM_STRING=$(base64 /dev/urandom | tr -d '/+' | dd bs=6 count=1 2>/dev/null)

    # Set Composer repo
    composer config repositories.${RANDOM_STRING} '{"type": "path", "url": "'${FOUNDATION}'"}'

    # Require arkecosystem/foundation
    composer require arkecosystem/foundation --ignore-platform-reqs -W

    # Remove node_modules folder
    rm -rf ${FOUNDATION}/node_modules

    # Symlink to arkecosystem/foundation node_modules folder
    ln -s $(pwd)/node_modules ${FOUNDATION}/node_modules

    # Create .symlink_foundation temp file
    echo ${FOUNDATION} >> .symlink_foundation

    # Inform user that all went ok
    echo "${FOUNDATION} has been symlinked"
}

function unlink:foundation() {

    # Get path from .symlink_foundation file or from args or guess it
    if [ -f .symlink_foundation ]; then
        FOUNDATION=$(cat .symlink_foundation)
    elif [ "$1" != "" ]; then
        FOUNDATION="$1"
    elif [ -d ../laravel-foundation ]; then
        FOUNDATION="../laravel-foundation"
    elif [ -d ../../laravel-foundation ]; then
        FOUNDATION="../../laravel-foundation"
    else
        echo "Unable to find `laravel-foundation`"
        return
    fi

    # Remove symlink
    unlink ${FOUNDATION}/node_modules

    # Remove temp file
    rm -rf .symlink_foundation

    # Clean up repo
    git reset --hard
    git clean -df

    # Inform user that all went ok
    echo "${FOUNDATION} symlink has been removed"
}
```

###  Health Score

61

—

FairBetter than 99% of packages

Maintenance88

Actively maintained with recent releases

Popularity34

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity87

Battle-tested with a long release history

 Bus Factor3

3 contributors hold 50%+ of commits

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

Recently: every ~28 days

Total

538

Last Release

59d ago

Major Versions

14.1.0 → 15.0.02024-04-24

15.0.0 → 16.0.02024-04-25

16.3.0 → 17.0.02024-09-04

17.0.0 → 18.0.02024-09-27

18.1.0 → 19.0.02024-10-23

PHP version history (2 changes)0.0.1PHP ^8.0

19.11.0PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/c1c55ad6edf98d82d17f8ae202a123a3c8028785ca6588b384e31b5134d69222?d=identicon)[itsanametoo](/maintainers/itsanametoo)

---

Top Contributors

[![alexbarnsley](https://avatars.githubusercontent.com/u/8069294?v=4)](https://github.com/alexbarnsley "alexbarnsley (230 commits)")[![ItsANameToo](https://avatars.githubusercontent.com/u/35610748?v=4)](https://github.com/ItsANameToo "ItsANameToo (94 commits)")[![alfonsobries](https://avatars.githubusercontent.com/u/17262776?v=4)](https://github.com/alfonsobries "alfonsobries (81 commits)")[![crnkovic](https://avatars.githubusercontent.com/u/6536260?v=4)](https://github.com/crnkovic "crnkovic (68 commits)")[![leMaur](https://avatars.githubusercontent.com/u/2118799?v=4)](https://github.com/leMaur "leMaur (52 commits)")[![faustbrian](https://avatars.githubusercontent.com/u/22145591?v=4)](https://github.com/faustbrian "faustbrian (47 commits)")[![stefro](https://avatars.githubusercontent.com/u/5249559?v=4)](https://github.com/stefro "stefro (33 commits)")[![chriship](https://avatars.githubusercontent.com/u/4815637?v=4)](https://github.com/chriship "chriship (32 commits)")[![Highjhacker](https://avatars.githubusercontent.com/u/5347826?v=4)](https://github.com/Highjhacker "Highjhacker (16 commits)")[![marianogoldman](https://avatars.githubusercontent.com/u/959563?v=4)](https://github.com/marianogoldman "marianogoldman (1 commits)")

### Embed Badge

![Health badge](/badges/arkecosystem-foundation/health.svg)

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

###  Alternatives

[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

22.8k69.3k](/packages/grumpydictator-firefly-iii)[blair2004/nexopos

The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js.

1.2k2.3k](/packages/blair2004-nexopos)[aedart/athenaeum

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

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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