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 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:
-
Navigate to your pages folder —
user/pages/— and create a new folder. In this example, we'll use explicit default ordering and call the folder03.mypage. -
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. -
Save this file in
user/pages/03.mypage/asdefault.md. That tells Grav to render the page using the default template from Quark 2. -
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 — Pico CSS, Font Awesome 7, auto/light/dark mode with
localStoragepersistence, 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-noticesplugin has been replaced bygithub-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.