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:
-
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 — Blades 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.
Note
Quark 2 is Grav 2.0's default theme. It uses Blades CSS (the actively maintained successor to Pico CSS) as a classless foundation, layered with a Cal.com-inspired design system. Full Blades capabilities are documented in the Official Blades CSS Docs.
The Quark 2 theme is Grav's new default, replacing the long-serving Quark (1.x) theme. It pairs a pure-grayscale palette with Cal Sans for display and Inter for body text (both hosted locally), Font Awesome 7 icons, and auto/light/dark appearance that persists in the user's browser. The layout system is CSS Grid + modern custom properties rather than a framework grid.
Headings
Quark 2 uses Cal Sans for display headings and treats h1 / h2 distinctly — h1 sits at a lighter display weight while h2 is bolder and gains a small accent bar to mark section breaks. h6 is rendered as an uppercase eyebrow label.
H1 Heading — airy, display weight
H2 Heading — confident, with accent bar
H3 Heading — workhorse section heading
H4 Heading
H5 Heading
H6 Heading — uppercase eyebrow
# H1 Heading
## H2 Heading
### H3 Heading
#### H4 Heading
##### H5 Heading
###### H6 Heading
Paragraphs
Body copy is set in Inter at 16px with a 1.7 line-height and subtle tracking. Links adopt the theme's accent color — by default a restrained charcoal, but configurable to any hex via Themes → Quark 2 → Accent Color.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent risus leo, dictum in vehicula sit amet, feugiat tempus tellus. Duis quis sodales risus. Etiam euismod ornare consequat.
Climb leg rub face on everything give attitude nap all day for under the bed. Chase mice attack feet but rub face on everything hopped up on goofballs.
Markdown Semantic Text Elements
Bold **Bold**
Italic _Italic_
Deleted ~~Deleted~~
Inline Code `Inline Code`
HTML Semantic Text Elements
I18N <abbr>
Citation <cite>
Ctrl + S <kbd>
TextSuperscripted <sup>
TextSubscripted <sub>
Underlined <u>
Highlighted <mark>
<time>
x = y + 2 <var>
Blockquote
The advance of technology is based on making it fit in so that you don't really even notice it, so it's part of everyday life.
- Bill Gates
> The advance of technology is based on making it fit in so that you don't really even notice it,
> so it's part of everyday life.
>
> <cite>- Bill Gates</cite>
Unordered List
- list item 1
- list item 2
- list item 2.1
- list item 2.2
- list item 2.3
- list item 3
* list item 1
* list item 2
* list item 2.1
* list item 2.2
* list item 2.3
* list item 3
Ordered List
- list item 1
- list item 2
- list item 2.1
- list item 2.2
- list item 2.3
- list item 3
1. list item 1
1. list item 2
1. list item 2.1
1. list item 2.2
1. list item 2.3
1. list item 3
Table
| Name | Genre | Release date |
|---|---|---|
| The Shawshank Redemption | Crime, Drama | 14 October 1994 |
| The Godfather | Crime, Drama | 24 March 1972 |
| Schindler's List | Biography, Drama, History | 4 February 1994 |
| Se7en | Crime, Drama, Mystery | 22 September 1995 |
| Name | Genre | Release date |
| :-------------------------- | :---------------------------: | -------------------: |
| The Shawshank Redemption | Crime, Drama | 14 October 1994 |
| The Godfather | Crime, Drama | 24 March 1972 |
| Schindler's List | Biography, Drama, History | 4 February 1994 |
| Se7en | Crime, Drama, Mystery | 22 September 1995 |
Alerts
Grav 2.0 replaces the legacy markdown-notices plugin with github-markdown-alerts, which renders GitHub-flavored Markdown alerts. Five types are available, each with an accent stripe, icon, and label:
Note
Highlights information that users should take into account, even when skimming.
Tip
Optional information to help a user be more successful.
Important
Crucial information necessary for users to succeed.
Warning
Critical content demanding immediate user attention due to potential risks.
Caution
Negative potential consequences of an action.
> [!NOTE]
> Highlights information that users should take into account, even when skimming.
> [!TIP]
> Optional information to help a user be more successful.
> [!IMPORTANT]
> Crucial information necessary for users to succeed.
> [!WARNING]
> Critical content demanding immediate user attention due to potential risks.
> [!CAUTION]
> Negative potential consequences of an action.