ContextQMD
Back to Grav

Home

user/pages/01.home/default.md

2.0.134.4 KB
Original Source

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.

[!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.

[!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. You'll 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, we'll 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.

[!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.

What's new in Grav 2.0

Grav 2.0 is the biggest release in the project's 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 that's 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.

[!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.