Home

Say Hello to Grav 2.0!

installation successful

Congratulations! You have installed the Base Grav 2.0 Package that provides a simple page and the new default Quark 2 theme to get you started — built on Blades CSS (the actively maintained successor to Pico CSS), Font Awesome 7, and a refined typographic system with light/dark/auto appearance.

<svg class=“octicon octicon-alert inline-block ” viewBox=“0 0 16 16” version=“1.1” width=“16” height=“16” aria-hidden=“true”><path d=“M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z”></path></svg> Warning

If you see a 404 Error when you click Typography in the menu, please refer to the troubleshooting guide.

Find out all about Grav

  • Learn about Grav by checking out our dedicated Learn Grav site.
  • Download plugins, themes, and Grav skeleton packages from the Grav Downloads page.
  • Follow the Grav Development Blog to keep up with the latest happenings in the Grav-verse.
  • Browse the source on GitHub and file issues or pull requests there.

<svg class=“octicon octicon-light-bulb inline-block ” viewBox=“0 0 16 16” version=“1.1” width=“16” height=“16” aria-hidden=“true”><path d=“M8 1.5c-2.363 0-4 1.69-4 3.75 0 .984.424 1.625.984 2.304l.214.253c.223.264.47.556.673.848.284.411.537.896.621 1.49a.75.75 0 0 1-1.484.211c-.04-.282-.163-.547-.37-.847a8.456 8.456 0 0 0-.542-.68c-.084-.1-.173-.205-.268-.32C3.201 7.75 2.5 6.766 2.5 5.25 2.5 2.31 4.863 0 8 0s5.5 2.31 5.5 5.25c0 1.516-.701 2.5-1.328 3.259-.095.115-.184.22-.268.319-.207.245-.383.453-.541.681-.208.3-.33.565-.37.847a.751.751 0 0 1-1.485-.212c.084-.593.337-1.078.621-1.489.203-.292.45-.584.673-.848.075-.088.147-.173.213-.253.561-.679.985-1.32.985-2.304 0-2.06-1.637-3.75-4-3.75ZM5.75 12h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM6 15.25a.75.75 0 0 1 .75-.75h2.5a.75.75 0 0 1 0 1.5h-2.5a.75.75 0 0 1-.75-.75Z”></path></svg> Tip

If you want a more full-featured base install, check out the Skeleton packages available in the downloads — several have already been updated for Grav 2.0.

Edit this Page

To edit this page, navigate to the folder you installed Grav into, and browse to the user/pages/01.home folder. Open default.md in your editor of choice. Youll see the content of this page written in Markdown format.

Create a New Page

Creating a new page is a simple affair in Grav. Follow these steps:

  1. Navigate to your pages folder — user/pages/ — and create a new folder. In this example, well use explicit default ordering and call the folder 03.mypage.

  2. Launch your text editor and paste in the following sample content:

    ---
    title: My New Page
    ---
    # My New Page!
    
    This is the body of **my new page** and I can easily use _Markdown_ syntax here.
  3. Save this file in user/pages/03.mypage/ as default.md. That tells Grav to render the page using the default template from Quark 2.

  4. Reload your browser to see your new page appear in the menu.

<svg class=“octicon octicon-info inline-block ” viewBox=“0 0 16 16” version=“1.1” width=“16” height=“16” aria-hidden=“true”><path d=“M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z”></path></svg> Note

The page will automatically show up in the menu after the Typography item. If you want a different label, add menu: My Page between the dashes in the front matter — this is the YAML header block, where all per-page options are configured.

Whats new in Grav 2.0

Grav 2.0 is the biggest release in the projects history — a modernized core, a rebuilt admin, a fresh default theme, and an updated dependency stack. Most of what you already know still works, but everything underneath has been sharpened.

  • PHP 8.3+ baseline, with a modernized core and typed internals throughout.
  • Symfony 7 + Twig 3 dependency stack, bringing the latest framework improvements and long-term support.
  • Quark 2 as the default theme — Blades CSS, Font Awesome 7, auto/light/dark mode with localStorage persistence, locally-hosted Cal Sans + Inter fonts, and a refined Cal.com-inspired design system.
  • Admin 2.0 — a fully API-powered SPA interface thats dramatically faster, more responsive, and decoupled from page renders. Navigation, form saves, and media operations no longer trigger full reloads.
  • Public REST API — the same endpoints that power Admin 2.0 are available to your own tools and integrations.
  • GitHub Markdown Alerts — the legacy markdown-notices plugin has been replaced by github-markdown-alerts, using the familiar > [!NOTE] / [!TIP] / [!IMPORTANT] / [!WARNING] / [!CAUTION] syntax.
  • Refined caching and asset pipeline — cleaner invalidation, faster cold starts, and smarter dependency fingerprinting.
  • Hardened security defaults — tightened CSP headers, modern session handling, and improved input sanitization across core plugins.
  • Better developer ergonomics — stricter type hints, cleaner event signatures, and clearer deprecation paths.

<svg class=“octicon octicon-report inline-block ” viewBox=“0 0 16 16” version=“1.1” width=“16” height=“16” aria-hidden=“true”><path d=“M0 1.75C0 .784.784 0 1.75 0h12.5C15.216 0 16 .784 16 1.75v9.5A1.75 1.75 0 0 1 14.25 13H8.06l-2.573 2.573A1.458 1.458 0 0 1 3 14.543V13H1.75A1.75 1.75 0 0 1 0 11.25Zm1.75-.25a.25.25 0 0 0-.25.25v9.5c0 .138.112.25.25.25h2a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h6.5a.25.25 0 0 0 .25-.25v-9.5a.25.25 0 0 0-.25-.25Zm7 2.25v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 9a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z”></path></svg> Important

Upgrading from Grav 1.x requires a migration. Follow the step-by-step guide at getgrav.org/migrate-to-2 — it covers pre-flight checks, the migration itself, and what to verify afterward.