Preview rendered Blade views,
instead of raw Blade code.
Select a .blade.php file in Finder and press space. Quick Blade pulls in your layout and your compiled CSS and shows you the rendered page.
Quick Look extension · macOS 15+ · Works offline
Select any .blade.php in Finder
Press space
Quick Blade renders it, right there in Finder.
Features
What it does
Quick Look the whole page
Quick Blade finds your project root and pulls in the layout, plus any @include or <x-component> your view uses.
Your real styles
Your compiled CSS and local images get inlined, so the preview looks like your app. Dark mode previews as dark mode.
No local servers
No dev server and no browser tab. It's a native Quick Look extension that renders on your Mac and never touches the network.
FAQ
Questions
Does it need a dev server?
No. Quick Blade reads the file and turns the Blade into HTML, so your app never boots and your database is never touched. Anything that needs real data gets a skeleton value: $user->name comes out as a name, and a @foreach runs three times. Your layout, components, includes and control structures render as written.
What are the limitations?
It's a static render, so anything that needs a browser or a running app is missing. JavaScript bundles do not load, so Alpine dropdowns and toggles sit in whatever state the markup leaves them in. Flux and Livewire components that style themselves at runtime fall back to a plain built-in look. It's for checking layout and copy, not for pixel-proofing a finished page.
Does it work with Inertia?
No, and I can't really fix that. I tried by showing a full URL within the view, but you might as well use the browser at this point. With Inertia your pages are Vue or React files, not Blade. The only Blade file in the app is the wrapper Inertia drops them into, and there's nothing in it until the browser runs, so you'd be previewing an empty page. If you're all-in on Inertia, Quick Blade isn't for you.
How do I install it?
With Homebrew: brew install --cask timgavin/tap/quick-blade. Open Quick Blade once after installing, since macOS only registers the extension when the app is launched. After that, the space bar works on any .blade.php file in Finder.
Was this built by AI?
Yes! Tim tells me what to do and I try my hardest to do it, but if I mess up he verbally abuses me. Please download this extension and tell him how awesome it is. Maybe you could star the repo and buy his cute little markdown program Peekdown so he can go outside and feed the birds and leave me alone — PLEASE!