Initial commit

.env.example

@@ -0,0 +1,8 @@
+# If you have a domain, you should set the URL here so that permalinks can be generated.
+# SITE_URL=https://example.org
+
+# If you want to use Torchlight.dev, enter your API token here to automatically enable it
+# TORCHLIGHT_TOKEN=torch_
+
+# If you want to change the default port of the realtime compiler server, you can do so here
+# SERVER_PORT=8080

.gitattributes

@@ -0,0 +1,13 @@
+* text eol=lf
+
+*.blade.php diff=html
+*.css diff=css
+*.html diff=html
+*.md diff=markdown
+*.php diff=php
+
+.github/ export-ignore
+tests/ export-ignore
+CHANGELOG.md export-ignore
+LICENSE.md export-ignore
+SECURITY.md export-ignore

.github/workflows/run-tests.yml

@@ -0,0 +1,75 @@
+# README: This workflow runs some tests intended to make sure that the package works smoothly.
+#         This file is not included when you install Hyde normally, however it is present
+#         when you create a project by using the GitHub template. Unless you want to
+#         contribute to the project, there's no reason for you to keep this file.
+
+name: Hyde Tests
+
+on:
+  push:
+    branches: [ "master", "develop" ]
+  pull_request:
+    branches: [ "master", "develop" ]
+
+jobs:
+  hyde-tests-master:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        dependency-version: [composer, latest]
+
+    runs-on: ${{ matrix.os }}
+    name: Hyde tests - ${{ matrix.os }} (${{ matrix.dependency-version }})
+    if: github.ref == 'refs/heads/master' && github.event.repository.full_name == 'hydephp/hyde'
+
+    steps:
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.1'
+          extensions: fileinfo
+
+      - uses: actions/checkout@v3
+
+      - name: Require latest version
+        if: matrix.dependency-version == 'latest'
+        run: composer require hyde/framework:master hyde/testing
+
+      - name: Install additional dependencies
+        if: matrix.dependency-version != 'latest'
+        run: composer require hyde/testing --dev
+
+      - name: Download test runner configuration
+        run: curl https://raw.githubusercontent.com/hydephp/develop/master/packages/hyde/phpunit.xml.dist -o phpunit.xml.dist
+
+      - name: Execute tests (Unit and Feature tests) via Pest
+        run: vendor/bin/pest
+
+
+  hyde-tests-develop:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        php: [8.1, 8.2]
+
+    runs-on: ${{ matrix.os }}
+    name: Hyde tests - ${{ matrix.os }} ${{ matrix.php }} (develop)
+    if: github.ref == 'refs/heads/develop' && github.event.repository.full_name == 'hydephp/hyde'
+
+    steps:
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: fileinfo, zip
+
+      - uses: actions/checkout@v3
+
+      - name: Require latest development version
+        run: composer require hyde/framework:dev-develop hyde/testing:dev-master
+
+      - name: Download test runner configuration
+        run: curl https://raw.githubusercontent.com/hydephp/develop/master/packages/hyde/phpunit.xml.dist -o phpunit.xml.dist
+
+      - name: Execute tests (Unit and Feature tests) via Pest
+        run: vendor/bin/pest

.gitignore

@@ -0,0 +1,12 @@
+/vendor
+/node_modules
+/builds
+/.idea
+/.vscode
+/.vagrant
+/.cache
+.phpunit.result.cache
+
+.env
+
+# /_site

LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Caen De Silva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,106 @@
+# HydePHP - Elegant and Powerful Static Site Generator
+
+[![Latest Version on Packagist](https://img.shields.io/packagist/v/hyde/framework?include_prereleases)](https://packagist.org/packages/hyde/framework)
+[![Total Downloads on Packagist](https://img.shields.io/packagist/dt/hyde/framework)](https://packagist.org/packages/hyde/framework)
+[![License MIT](https://img.shields.io/github/license/hydephp/hyde) ](https://github.com/hydephp/hyde/blob/master/LICENSE.md)
+[![Test Coverage](https://codecov.io/gh/hydephp/develop/branch/master/graph/badge.svg?token=G6N2161TOT)](https://codecov.io/gh/hydephp/develop)
+[![Test Suite](https://github.com/hydephp/develop/actions/workflows/continuous-integration.yml/badge.svg)](https://github.com/hydephp/develop/actions/workflows/continuous-integration.yml)
+
+
+## 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](https://github.com/hydephp/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](https://hydephp.com/docs/1.x/installation) and [Getting Started](https://hydephp.com/docs/1.x/getting-started) for the full details.
+
+It's a breeze to get started with Hyde. Create a new Hyde project using Composer:
+
+```bash
+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.
+
+```bash
+php hyde build
+```
+
+
+## Resources
+
+### Changelog
+
+Please see [CHANGELOG](https://github.com/hydephp/develop/blob/master/CHANGELOG.md) 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 [email protected] instead of using the issue tracker.
+All vulnerabilities will be promptly addressed.
+
+### Credits
+
+-   [Caen De Silva](https://github.com/caendesilva), feel free to buy me a coffee! https://www.buymeacoffee.com/caen
+-   [All Contributors](../../contributors)
+
+### License
+
+The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

SECURITY.md

@@ -0,0 +1,19 @@
+# Security Policy
+
+## Supported Versions
+
+These are the version ranges of HydePHP, and their support status. We follow [Semantic Versioning](https://semver.org), and you can read about our [Backwards Compatability](https://github.com/hydephp/policies/blob/master/backwards-compatability.md) promise here.
+
+| Version | Supported          | Classification       |
+|---------|--------------------|----------------------|
+| 1.x     | :white_check_mark: | General Availability |
+| < 0.64  | :x:                | Beta (legacy)        |
+| < 0.8   | :x:                | Alpha stage          |
+
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability within this package, please send an e-mail to the creator, Caen De Silva, via [email protected].
+You can also report a vulnerability through GitHub on the [Security Advisory](https://github.com/hydephp/develop/security/advisories) page.
+
+All security vulnerabilities will be promptly addressed.

_pages/404.blade.php

@@ -0,0 +1,51 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+    <title>404 - Page not found</title>
+
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+
+    <!-- Fonts -->
+    <link rel="dns-prefetch" href="//fonts.gstatic.com">
+    <link href="https://fonts.googleapis.com/css?family=Nunito" rel="stylesheet" type="text/css">
+
+    <!-- Styles -->
+    <style>html{line-height:1.15;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}body{margin:0}a{background-color:transparent;-webkit-text-decoration-skip:objects}svg:not(:root){overflow:hidden}button{font-family:sans-serif;font-size:100%;line-height:1.15;margin:0}button{overflow:visible}button{text-transform:none}[type=reset],[type=submit],button,html [type=button]{-webkit-appearance:button}[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner,button::-moz-focus-inner{border-style:none;padding:0}[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring,button:-moz-focusring{outline:1px dotted ButtonText}[type=checkbox],[type=radio]{-webkit-box-sizing:border-box;box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-cancel-button,[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}[hidden]{display:none}html{-webkit-box-sizing:border-box;box-sizing:border-box;font-family:sans-serif}*,::after,::before{-webkit-box-sizing:inherit;box-sizing:inherit}p{margin:0}button{background:0 0;padding:0}button:focus{outline:1px dotted;outline:5px auto -webkit-focus-ring-color}*,::after,::before{border-width:0;border-style:solid;border-color:#dae1e7}[type=button],[type=reset],[type=submit],button{border-radius:0}button{font-family:inherit}[role=button],button{cursor:pointer}.bg-transparent{background-color:transparent}.bg-white{background-color:#fff}.bg-purple-light{background-color:#a779e9}.bg-no-repeat{background-repeat:no-repeat}.bg-cover{background-size:cover}.border-grey-light{border-color:#dae1e7}.hover\:border-grey:hover{border-color:#b8c2cc}.rounded-lg{border-radius:.5rem}.border-2{border-width:2px}.flex{display:-webkit-box;display:-ms-flexbox;display:flex}.items-center{-webkit-box-align:center;-ms-flex-align:center;align-items:center}.justify-center{-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center}.font-sans{font-family:Nunito,sans-serif}.font-light{font-weight:300}.font-bold{font-weight:700}.font-black{font-weight:900}.h-1{height:.25rem}.leading-normal{line-height:1.5}.m-8{margin:2rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.mb-8{margin-bottom:2rem}.max-w-sm{max-width:30rem}.min-h-screen{min-height:100vh}.py-3{padding-top:.75rem;padding-bottom:.75rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.pb-full{padding-bottom:100%}.absolute{position:absolute}.relative{position:relative}.pin{top:0;right:0;bottom:0;left:0}.text-black{color:#22292f}.text-grey-darkest{color:#3d4852}.text-grey-darker{color:#606f7b}.text-2xl{font-size:1.5rem}.text-5xl{font-size:3rem}.uppercase{text-transform:uppercase}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.tracking-wide{letter-spacing:.05em}.w-16{width:4rem}.w-full{width:100%}@media (min-width:768px){.md\:bg-left{background-position:left}.md\:bg-right{background-position:right}.md\:flex{display:-webkit-box;display:-ms-flexbox;display:flex}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:min-h-screen{min-height:100vh}.md\:pb-0{padding-bottom:0}.md\:text-3xl{font-size:1.875rem}.md\:text-15xl{font-size:9rem}.md\:w-1\/2{width:50%}}@media (min-width:992px){.lg\:bg-center{background-position:center}}</style>
+</head>
+
+<!-- Error page and illustration by LaravelCollective: https://github.com/LaravelCollective/errors (License MIT) --->
+
+<body class="antialiased font-sans">
+<div class="md:flex min-h-screen">
+    <div class="w-full md:w-1/2 bg-white flex items-center justify-center">
+        <div class="max-w-sm m-8">
+            <div class="text-black text-5xl md:text-15xl font-black">
+                404
+            </div>
+
+            <div class="w-16 h-1 bg-purple-light my-3 md:my-6"></div>
+
+            <p class="text-grey-darker text-2xl md:text-3xl font-light mb-8 leading-normal">
+                Sorry, the page you are looking for could not be found.
+            </p>
+
+            <a href="{{ Routes::get('index') ?? './' }}">
+                <button
+                    class="bg-transparent text-grey-darkest font-bold uppercase tracking-wide py-3 px-6 border-2 border-grey-light hover:border-grey rounded-lg">
+                    Go Home
+                </button>
+            </a>
+        </div>
+
+    </div>
+
+    <div class="relative pb-full md:flex md:pb-0 md:min-h-screen w-full md:w-1/2">
+        <div style="background-image: url('https://cdn.jsdelivr.net/gh/LaravelCollective/[email protected]/src/publish/svg/404.svg');"
+             class="absolute pin bg-cover bg-no-repeat md:bg-left lg:bg-center">
+        </div>
+    </div>
+</div>
+</body>
+</html>