hyde / hyde
Static Site Generator to rapidly create Blogs, Documentation Sites, and more, using Markdown and Blade.
Fund package maintenance!
Open Collective
www.buymeacoffee.com/caen
Installs: 1 374
Dependents: 0
Suggesters: 1
Security: 0
Stars: 247
Watchers: 3
Forks: 9
Open Issues: 0
Type:project
Requires
- php: ^8.1
- hyde/framework: ^1.7
- laravel-zero/framework: ^10.0
Requires (Dev)
- hyde/realtime-compiler: ^3.3
- dev-master
- v1.7.1
- v1.7.0
- v1.6.1
- v1.6.0
- v1.5.0
- v1.4.2
- v1.4.1
- v1.4.0
- v1.3.0
- v1.2.0
- v1.1.0
- v1.0.0
- v1.0.0-RC.8
- v1.0.0-RC.7
- v1.0.0-RC.6
- v1.0.0-RC.5
- v1.0.0-RC.4
- v1.0.0-RC.3
- v1.0.0-RC.2
- v1.0.0-RC.1.1
- v1.0.0-RC.1
- v0.64.0-beta
- v0.63.0-beta
- v0.62.0-beta
- v0.61.0-beta
- v0.60.0-beta
- v0.59.0-beta
- v0.58.0-beta
- v0.57.0-beta
- v0.56.0-beta
- v0.55.0-beta
- v0.54.0-beta
- v0.53.0-beta
- v0.52.0-beta
- v0.51.0-beta
- v0.50.0-beta
- v0.49.0-beta
- v0.48.0-beta
- v0.47.0-beta
- v0.46.0-beta
- v0.45.0-beta
- v0.44.0-beta
- v0.43.0-beta
- v0.42.0-beta
- v0.41.0-beta
- v0.40.0-beta.2
- v0.40.0-beta.1
- v0.40.0-beta
- v0.39.0-beta
- v0.38.0-beta
- v0.37.2-beta
- v0.37.1-beta
- v0.37.0-beta
- v0.36.0-beta
- v0.35.0-beta
- v0.34.1-beta
- v0.34.0-beta
- v0.33.0-beta
- v0.32.3-beta
- v0.32.2-beta
- v0.32.1-beta
- v0.32.0-beta
- v0.31.0-beta
- v0.30.1-beta
- v0.30.0-beta
- v0.29.0-beta
- v0.28.1-beta
- v0.28.0-beta
- v0.27.1-beta
- v0.27.0-beta
- v0.26.0-beta
- v0.25.0-beta
- v0.24.1-beta
- v0.24.0-beta
- v0.23.0-beta
- v0.22.0-beta
- v0.21.0-beta
- v0.20.0-beta
- v0.19.0-beta
- v0.18.0-beta
- v0.17.1-beta
- v0.17.0-beta
- v0.16.1-beta
- v0.16.0-beta
- v0.15.0-beta
- v0.14.0-beta
- v0.13.0-beta
- v0.12.0-beta
- v0.11.0-beta
- v0.10.0-beta
- v0.9.0-alpha
- v0.8.0-alpha
- v0.7.3-alpha
- v0.7.2-alpha
- v0.7.1-alpha
- v0.7.0-alpha
- v0.6.0-alpha
- v0.5.0-alpha
- v0.4.1-alpha
- v0.4.0-alpha
- v0.3.3-alpha
- v0.3.2-alpha
- v0.3.1-alpha
- v0.3.0-alpha
- v0.2.1-alpha
- v0.2.0-alpha
- dev-develop
This package is auto-updated.
Last update: 2024-12-05 09:39:43 UTC
README
Make static websites, blogs, and documentation pages with the tools you already know and love.
About HydePHP
HydePHP is a content-first Laravel-powered console application that allows you to create static HTML pages, blog posts, and documentation sites, using your choice of Markdown and/or Blade.
Build sites in record-time with a full batteries-included TailwindCSS frontend that just works without any fuzz.
Speed & simplicity first, full control when you need it.
Hyde is all about letting you get started quickly by giving you a full-featured frontend starter kit, while also giving you the power and freedom of doing things the way you want to.
Markdown purist? That's all you need. Blade artisan? Go for it. Hyde comes with hand-crafted frontend templates, so you can focus on your content. You don't need to customize anything. But you can customize everything.
See the documentation and learn more at https://hydephp.com/docs
Features
Content Creation
- Create blog posts using Markdown and Front Matter.
- Create documentation pages from plain Markdown, no front matter needed!
- Create simple pages using Markdown, or create advanced ones using Laravel Blade.
- You can scaffold blog posts and Markdown pages to automatically fill in the front matter.
- You can also scaffold Blade pages to automatically use the default layout.
Built-in Frontend
- Hyde comes with a TailwindCSS starter kit, so you can start making content right away.
- The starter kit is fully responsive, has a dark mode theme, and is customizable.
- The frontend is accessible to screen-readers and rich with semantic HTML and microdata.
- Hyde automatically chooses the right layout to use depending on the content being rendered.
- Hyde also fills in and creates content like navigation menus and sidebars automatically.
Easy Asset Managing
- The Hyde starter comes with HydeFront to serve the base stylesheet and JavaScript through the jsDelivr CDN.
- Hyde ships with precompiled and minified TailwindCSS styles in the app.css file, you can also load them through the CDN.
- This means that all the styles you need are already installed. However, if you want to customize the included Tailwind config, or if you add new Tailwind classes through Blade files, you can simply run the
npm run dev
command to recompile the styles using the pre-configured Laravel Mix package.
Customization
- You don't need to configure anything as Hyde is shipped with sensible defaults.
- You can, however, customize nearly everything. Here are just a few out of many examples:
- All frontend components and page layouts are created with Blade, so you can publish the vendor views, just like in Laravel.
- Override many of the dynamic content features like the menus and footer.
Getting Started - High-level overview
See Installation Guide and Getting Started for the full details.
It's a breeze to get started with Hyde. Create a new Hyde project using Composer:
composer create-project hyde/hyde
Next, place your Markdown files in one of the content directories: _posts
, _docs
, and _pages
which also accepts Blade files. You can also use the hyde:make
commands to scaffold them.
When you're ready, run the build command to compile your static site which will save your HTML files in the _site
directory.
php hyde build
Resources
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
HydePHP is an open-source project, contributions are very welcome!
Development is made in the HydePHP Monorepo, which you can find here https://github.com/hydephp/develop.
Security
If you discover any security-related issues, please email caen@desilva.se instead of using the issue tracker, or use the GitHub Security Advisory page. All vulnerabilities will be promptly addressed.
Credits
- Caen De Silva, feel free to buy me a coffee! https://www.buymeacoffee.com/caen
- All Contributors
License
The MIT License (MIT). Please see License File for more information.