Skip to content

Latest commit

 

History

History
99 lines (70 loc) · 3.89 KB

README.md

File metadata and controls

99 lines (70 loc) · 3.89 KB
Raw

Folio for Laravel logo.

A customizable Laravel content-management system. (Currently in beta.)

Live Examples

Nono.MA | Getting Simple | Lourdes.AC | AR-MA | Getting Architecture Done | Nacho.MA | Burns.art | RCA Media Studies | Luis Ruiz Padrón

Installation · Laravel 8.x

  • Add alternate VCS repos for packages without Laravel 8 support to composer.json.
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/nonoesp/laravel-imgix"
        }
    ],
  • composer require nonoesp/folio:dev-master
  • php artisan folio:install
  • php artisan migrate
  • php artisan migrate --path=vendor/mpociot/versionable/src/migrations
  • Add the following middleware to app/Http/Kernel.php:
    protected $middlewareGroups = [
        'web' => [
            /// nonoesp/folio
            \Nonoesp\Folio\Middleware\SetLocales::class,
        ],
    ];
  • Party! 🥳

Build Folio's Assets with Laravel Mix

You can fully customize the JavaScript and SCSS assets.

  • Publish Folio's assets
    • php artisan vendor:publish --provider="Nonoesp\Folio\FolioServiceProvider" --tag=dev-assets
  • Install npm dependencies
    • npm install nonoesp/folio-scss font-awesome vue vue-resource vue-focus lodash jquery jquery-lazy jquery-unveil validate-js vuedraggable @wordpress/wordcount animate.css
    • npm install
  • Build the assets with Laravel Mix and configurate it with webpack.mix.js
    • npm run prod · to build for production
    • npm run dev · to build for development
    • npm run watch · to rebuild on changes with BrowserSync

Customize Folio's Config, Views, Translations & Assets

Configure Folio by publishing config/folio.php.

# Config
php artisan vendor:publish --provider="Nonoesp\Folio\FolioServiceProvider" --tag=config

# Views
php artisan vendor:publish --provider="Nonoesp\Folio\FolioServiceProvider" --tag=views

# Translations
php artisan vendor:publish --provider="Nonoesp\Folio\FolioServiceProvider" --tag=lang

# JavaScript & SCSS assets
php artisan vendor:publish --provider="Nonoesp\Folio\FolioServiceProvider" --tag=dev-assets

Other

  • Subscriber email notifications can be configured in folio.subscribers and setting up Amazon SES in services.ses.
  • Backups can be configured by adding disks to backup.destination.disks (having those disks configured in filesystems, say Dropbox, Digital Ocean, or S3).

License

Folio is licensed under the MIT license.

Me

Hi. I'm Nono Martínez Alonso (Nono.MA), a computational designer with a penchant for simplicity.

I host Getting Simple—a podcast about how you can live a meaningful, creative, simple life—sketch things that call my attention, write about enjoying a slower life, and recently started live streaming and recording videos on machine learning, life hacking, and more.

Join the Discord community.

If you find Folio useful in any way, reach out on Twitter at @nonoesp. Cheers!

Elsewhere

🍃 Getting Simple
🎙 Podcast
🗣 Ask Questions
💬 Discord
👨🏻‍🎨 Sketches
✍🏻 Blog
🐦 Twitter
📸 Instagram