ezar101/litedocs

A lightweight static site generator.

1.0.2 2025-12-07 18:40 UTC

Requires

• php: >=8.4
• league/commonmark: ^2.8
• symfony/console: ^8.0
• symfony/event-dispatcher: ^8.0
• symfony/filesystem: ^8.0
• symfony/finder: ^8.0
• symfony/options-resolver: ^8.0
• symfony/yaml: ^8.0
• twig/twig: ^3.22

Requires (Dev)

• bamarni/composer-bin-plugin: ^1.8

MIT

• Ezar Affandi

README

LiteDocs

LiteDocs is a modern, lightweight, and blazing fast static site generator written in PHP 8.4+.
It is designed to build beautiful documentation sites from Markdown files with zero configuration.

📚 Read the Official Documentation

✨ Features

• ⚡ Zero Config: Works out of the box with sensible defaults.
• 🎨 Theming: Powerful templating engine based on Twig. Includes a modern "Lite" theme.
• 🔌 Plugins: Extensible architecture using Symfony EventDispatcher.
• 🌍 Multilingual: Native support for internationalization (i18n).
• 🔍 Search: Built-in client-side search engine (no external services required).
• 🛠 Developer Friendly: 100% PHP, easy to override and extend.

🚀 Installation

Option 1: Standalone PHAR (Recommended)

You can download the single executable file from the Releases Page.

wget https://github.com/Ezar101/LiteDocs/releases/latest/download/litedocs.phar
chmod +x litedocs.phar
sudo mv litedocs.phar /usr/local/bin/litedocs

Option 2: Via Composer

composer global require Ezar101/litedocs

🏁 Quick Start

1. Initialize a new project Create a litedocs.yml file and a docs/ folder with some markdown files.
2. Build the site Run the build command in your project directory:

litedocs build

1. Enjoy Your static site is generated in the site/ directory, ready to be deployed to GitHub Pages, Vercel, or Netlify.

⚙️ Configuration

Create a litedocs.yml file at the root of your project:

site_name: "My Awesome Docs"
docs_dir: "docs"
site_dir: "site"

# Enable multilingual support
languages:
    en: English
    fr: Français

# Theme configuration
theme:
    name: lite

# Import navigation and plugins
nav: "config/nav.yml"
plugins: "config/plugins.yml"

🤝 Contributing

Contributions are welcome! We enforce high code quality standards to keep the project maintainable.

Requirements

• PHP 8.4+
• Composer

Development Workflow

1. Fork the repository and create a new branch.
2. Install dependencies:

composer install

1. Write Tests: We use Pest PHP.

composer test

1. Analyze Code: Ensure static analysis passes.

composer analyse

1. Fix Style: Format your code to PSR-12 standards.

composer lint  # Check
composer fix   # Auto-fix

1. Submit a Pull Request.

Note: Our CI pipeline will automatically block any PR that does not pass tests or static analysis.

📄 License

LiteDocs is open-sourced software licensed under the MIT license.