LaraScura
See how Laravel works.
LaraScura is a local-first VS Code extension that visualizes Laravel architecture, follows request flows, and explains the PHP/Laravel syntax that created every connection.
It is designed for developers who want to understand Laravel—not merely browse a dependency graph.
Why LaraScura exists
LaraScura was created for people who understand systems better through flows and relationships than through punctuation and syntax. It is free because learning tools like this should be accessible to every young developer.
Free forever. No telemetry, no subscriptions, and no hidden costs. Just learn, build, and pass it on.
Features
- Detects reusable Laravel projects through
artisan and composer.json
- Maps routes to controllers and actions
- Shows route middleware
- Understands common route groups,
Route::match, resource routes, and API resource routes
- Detects constructor dependency injection
- Maps Eloquent relationships
- Detects jobs and events dispatched from classes
- Maps service-container bindings
- Classifies controllers, services, repositories, models, jobs, events, listeners, providers, and commands
- Opens the exact source line from every node and connection
- Explains Laravel concepts in English or Turkish
- Watches
app/ and routes/ for changes
- Packages as a normal installable VSIX
- Starts with a compact architecture overview instead of a full-graph hairball
- Navigates through request-flow modules, individual routes, and architecture layers
- Lets you move nodes into a layout that matches how you think
- Provides a collapsible Inspector that reopens whenever you select a node or connection
Privacy and security
LaraScura:
- does not send source code, graph data, or telemetry anywhere;
- does not load remote scripts, fonts, styles, or images;
- does not run
artisan, PHP, Composer, shell commands, or project code;
- uses static source analysis only;
- is disabled in untrusted workspaces;
- limits source navigation to the selected Laravel project;
- gives its Webview no local-resource access and uses a strict Content Security Policy.
See the bundled SECURITY.md file for the threat model.
Development
Requirements:
- Node.js 20+
- npm
- VS Code 1.95+
npm install
npm run check
npm run compile
Press F5 in VS Code to launch an Extension Development Host.
Install
Install LaraScura from the Visual Studio Code Marketplace, then open a Laravel project and run:
LaraScura: Open Architecture Map
Marketplace identifier: ooll.larascura
Package locally
npm run package:vsix
code --install-extension larascura-0.2.2.vsix
Static-analysis boundaries
Laravel permits dynamic routes, runtime service-container bindings, macros, package discovery, and magic methods. LaraScura reports exact matches when syntax is statically resolvable and keeps dynamic handlers as warnings instead of inventing connections.
The scanner will become more precise over time while preserving this rule: uncertainty must be visible.
Known limitations
LaraScura is an early release. It maps what it can resolve statically and stays silent instead of guessing. It does not yet resolve:
- Routes declared inside
Route::controller(...)->group(...). Their URI and middleware are correct, but the controller is reported as an unresolved handler.
- Resource routes that name their controller as a string (
Route::resource('tags', 'TagController')), and the plural Route::resources() / Route::apiResources() helpers.
- Classes that share a short name across namespaces. These are deliberately left unlinked rather than connected to the wrong class.
- Event-to-listener registration, middleware alias resolution, and anything registered at runtime through macros or dynamic container bindings.
A missing connection means the syntax was not statically resolvable — not that the connection does not exist.
Roadmap
- ✅ Route-group prefix and inherited middleware resolution — completed in
0.2.2
- Controller resolution for
Route::controller(...) groups
- Event-to-listener registration mapping
- Laravel middleware alias resolution
- Method-level request journey view
- Form Request, Policy, Resource, Notification, Mail, and Observer nodes
- Laravel-version-aware learning cards
- Multi-project workspace comparison
License
LaraScura is free and open-source software released under the MIT License. See the included LICENSE file. You may use, copy, modify, merge, publish, distribute, sublicense, and sell copies of the software, provided that the copyright and license notice remain included.
