PHPackages aschmelyun/taro - 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. [Templating & Views](/categories/templating) 4. / 5. aschmelyun/taro ActiveProject[Templating & Views](/categories/templating) aschmelyun/taro =============== A blazing-fast static site generator that uses JSON content files and the Laravel blade templating engine 0.2.0(7y ago)215MITPHPPHP >=5.6.4 Since Dec 17Pushed 7y ago1 watchersCompare [ Source](https://github.com/aschmelyun/taro)[ Packagist](https://packagist.org/packages/aschmelyun/taro)[ RSS](/packages/aschmelyun-taro/feed)WikiDiscussions master Synced 2mo ago READMEChangelog (3)Dependencies (2)Versions (4)Used By (0) Taro ==== [](#taro) [![Current Version](https://camo.githubusercontent.com/1d002ba74422b9da52589d700853a9efa39d91254a826c8df4e9603469dd0aee/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f617363686d656c79756e2f7461726f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aschmelyun/larametrics)[![License](https://camo.githubusercontent.com/4240de89ec1c4b0eda26626e1180378cdf950425b68ce2684e03bb0cf4bf752b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f617363686d656c79756e2f7461726f2e7376673f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/4240de89ec1c4b0eda26626e1180378cdf950425b68ce2684e03bb0cf4bf752b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f617363686d656c79756e2f7461726f2e7376673f7374796c653d666c61742d737175617265)[![Total Downloads](https://camo.githubusercontent.com/17cf99e27c3437f66e129726dedfa2962ff6d967aa78a05d3c7c42183faa11fc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f617363686d656c79756e2f7461726f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aschmelyun/taro) 🔥 A blazing-fast static site generator that uses JSON files for content and leverages the Laravel Blade templating engine. [![Screenshot of Taro building a site](https://camo.githubusercontent.com/d86b60f61de2ffd706f843667ba8d72e484735c60a28037b620c25e2810435b4/68747470733a2f2f692e696d6775722e636f6d2f4b78747062636d2e706e67)](https://camo.githubusercontent.com/d86b60f61de2ffd706f843667ba8d72e484735c60a28037b620c25e2810435b4/68747470733a2f2f692e696d6775722e636f6d2f4b78747062636d2e706e67) Requirements ------------ [](#requirements) - PHP 5.6.4 or higher Installation ------------ [](#installation) Starting a project with Taro is easy through Composer: ``` composer create-project aschmelyun/taro taro ``` After Composer finishes up, cd inside your project's root directory and install node dependencies: ``` npm install ``` From there you can build the demo site, which outputs to a `dist/` folder in your project root: ``` npm run dev ``` Adding a page ------------- [](#adding-a-page) Inside the `content/` directory you'll find a single hello-world.json file that you can reference or copy directly to create your new page. There are only two required properties that need to be set for the page to be built: - **view:** The Laravel Blade file that the content data should be passed to. You can exclude `.blade.php` in the filename, and even substitute the forward slashes (/) in the path with periods (.). All template files are relative to the views folder in your project's resources directory, so if you had a file at `resources/views/blog/page.blade.php` you would use **"view": "blog.page"** in your content's JSON file. - **slug:** This is the URL path relative to your root domain that you want the page published to. For example, if you wanted to create a page at `https://example.com/blog/this-cool-post` you would set the value of the slug property to **"/blog/this-cool-post"**. The rest of the properties in the JSON content file are directly passed as variables to your Blade file. If you have a property like **"foo": "bar"** calling `{{ $foo }}` in your Blade template will echo "bar". You're not limited to just `key:value` strings either, you can add in arrays and objects as well and they'll translate over directly to variables that you can use in your Blade templates. Modifying your assets --------------------- [](#modifying-your-assets) By default, Taro uses SCSS files that are compiled to CSS during the build process. There's a basic skeleton structure set up in the `resources/assets/sass` directory, that uses bootstrap's grid and reset stylesheets to give you a clean (and lightweight) slate to work with. There's a bootstrapped JavaScript file that imports lodash, jQuery, and Vue dependencies through npm to use with your project. That can be modified by editing the `resources/assets/js/app.js` file. Since we're using webpack to compile our assets, feel free to go crazy with modules and single-file components. Publishing your site -------------------- [](#publishing-your-site) Once you're ready to publish your site, simply run the command: ``` npm run production ``` Which will minify your assets and build the site again with the new versioned files. You can then publish your entire project to a host of your choice as long as the web root is pointed to the `/dist` folder. Additionally, you're free to just publish the built files in the dist folder by themselves. Roadmap ------- [](#roadmap) Taro is still very much in development, and while it's designed to remain as simple as possible there's a few features that could make for a better overall experience. Here's what's on the path ahead: - Re-build after changes in assets or content files - Live reloading after changes in assets or content files - Ability to use folders in content directory - Translate content structure to site structure, so slug would just be an override and not required - Ability to add in and use HTML in JSON content files - More detailed build errors if something goes wrong - A better cli interface and style during site builds Contact Info ------------ [](#contact-info) Have an issue? Submit it here! Want to get in touch? Feel free to reach out to me on [Twitter](https://twitter.com/aschmelyun) for any kind of general questions or comments. License ------- [](#license) The MIT License (MIT). See [LICENSE.md](https://github.com/aschmelyun/taro/blob/master/LICENSE.md) for more details. ### Health Score 23 — LowBetter than 27% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 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 ~6 days Total 3 Last Release 2687d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/89d40a36efd670c752d8d6e488192d9ae78b9ff49503cf6b671f46d17cb67768?d=identicon)[aschmelyun](/maintainers/aschmelyun) --- Top Contributors [![aschmelyun](https://avatars.githubusercontent.com/u/3395980?v=4)](https://github.com/aschmelyun "aschmelyun (12 commits)") ### Embed Badge ![Health badge](/badges/aschmelyun-taro/health.svg) ``` [![Health](https://phpackages.com/badges/aschmelyun-taro/health.svg)](https://phpackages.com/packages/aschmelyun-taro) ``` ### Alternatives [tightenco/jigsaw Simple static sites with Laravel's Blade. 2.2k438.5k29](/packages/tightenco-jigsaw)[friendsoftwig/twigcs Checkstyle automation for Twig 3586.1M60](/packages/friendsoftwig-twigcs)[twigstan/twigstan TwigStan is a static analyzer for Twig templates powered by PHPStan 27412.1k](/packages/twigstan-twigstan)[iq2i/storia-bundle UI Storia bundle 144.6k](/packages/iq2i-storia-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)