simai/docara

Simple static sites with Laravel's Blade. based on tightenco/jigsaw

v1.0.16 2025-12-02 11:28 UTC

Requires

• php: ^8.2
• elaborate-code/jigsaw-localization: ^1.1
• illuminate/collections: ^11.0 || ^12.0
• illuminate/console: ^11.0 || ^12.0
• illuminate/container: ^11.0 || ^12.0
• illuminate/filesystem: ^11.0 || ^12.0
• illuminate/support: ^11.0 || ^12.0
• illuminate/view: ^11.0 || ^12.0
• league/commonmark: ^2.4
• michelf/php-markdown: ^2.0
• mnapoli/front-yaml: ^2.0
• nunomaduro/collision: ^8.1
• ramsey/uuid: ^4.9
• samdark/sitemap: ^2.4.1
• spatie/laravel-ignition: ^2.4
• symfony/console: ^6.0 || ^7.0
• symfony/error-handler: ^6.0 || ^7.0
• symfony/finder: ^6.0 || ^7.0
• symfony/intl: ^7.3
• symfony/process: ^6.0 || ^7.0
• symfony/var-dumper: ^6.0 || ^7.0
• symfony/yaml: ^6.0 || ^7.0
• vlucas/phpdotenv: ^5.6

Requires (Dev)

• laravel/pint: ^1.16
• mockery/mockery: ^1.6
• phpunit/phpunit: ^11.0.6

MIT

• Adam Wathan
• Keith Damiani
• Jacob Baker-Kretzmar
• Alexander Kuzin

• generator
• static
• site
• laravel
• blade
• simai
• sf5

README

Quick start to install Docara via Composer and initialize a project.

Install the framework

composer require simai/docara

Initialize a new project

From an empty project directory:

php vendor/bin/docara init

This will:

• copy the base template (stubs),
• fetch source/_core (as submodule or clone),
• copy template configs from _core,
• run frontend dependency install (npm/yarn install in the project root).

Configure .env

Create .env in your project root (example):

AZURE_KEY=<AZURE_KEY>
AZURE_REGION=<AZURE_REGION>
AZURE_ENDPOINT=https://api.cognitive.microsofttranslator.com
DOCS_DIR=docs

Run

• Development/watch (if defined in your template): yarn run watch or npm run watch
• Build: yarn run prod / npm run prod (or your template’s build script)
• Translate test: php vendor/bin/docara translate --test
• Update existing project in-place (no delete/archive, keeps source/_core): php vendor/bin/docara init --update
• If you already have your own docs in source/docs, they won’t be overwritten; otherwise stubs/docs are copied.
• If you already have config.php in the project root, it will be preserved during init/update.

Structure

• source/ — your site source.
• source/_core/ — Docara/Jigsaw core (fetched automatically on init).
• stubs/ — template stubs used during docara init.
• build_* — build outputs.

License

MIT