Lucid Architecture for VS Code

Lucid Architecture VSCode Extension Referencing

Lucid Architecture VSCode Extension Go To Job

VS Code extension for Lucid Architecture — bring the CLI into the command palette, navigate your Features/Jobs/Operations from a sidebar tree view, and jump to any unit inline from ->run() calls.

Works with both Micro and Monolith Lucid projects. Automatically activates when vendor/lucidarch/lucid is detected in the workspace.

Features

Make Commands

Run any lucid make:* command directly from the command palette without leaving the editor. The extension collects arguments interactively — offering existing domains and services as quick picks — then opens the generated file automatically.

Cmd+Shift+P (or Ctrl+Shift+P) → type Lucid::

Command	Description
`Lucid: Make Feature`	Creates a new Feature class
`Lucid: Make Job`	Creates a new Job; prompts for domain and queueable option
`Lucid: Make Operation`	Creates a new Operation
`Lucid: Make Service`	Creates a new Service (Monolith only)
`Lucid: Make Controller`	Creates a new Controller
`Lucid: Make Model`	Creates a new Model
`Lucid: Make Request`	Creates a new Form Request
`Lucid: Make Policy`	Creates a new Policy
`Lucid: Make Migration`	Creates a new Migration
`Lucid: Initialize Micro`	Scaffolds a new Micro project
`Lucid: Initialize Monolith`	Scaffolds a new Monolith project
`Lucid: Delete Feature/Job/Operation`	Removes a unit with confirmation

Generated files use the Lucid package's own stubs — template updates in the package are reflected automatically.

Explorer Tree View

The Lucid Architecture panel in the Explorer sidebar shows your project structure at a glance:

Micro — Features / Domains (with Jobs) / Operations
Monolith — Services (with Features and Operations) / Domains (with Jobs)

Click any node to open the file. Right-click a Domain node to Make Job in this context (domain pre-filled), or right-click a Service node to Make Feature in this context.

The tree refreshes automatically when files are added or deleted.

CodeLens on `->run()` Calls

Every ->run() call in a Feature or Operation file gets an inline → Go to ClassName link. Clicking it navigates directly to that Job or Operation file.

Handles all three call styles:

$this->run(FindProductJob::class);
$this->run(new FindProductJob($id));
$this->run('FindProductJob');

Snippets

Type a prefix in any PHP file and press Tab:

Prefix	Expands to
`lucid-job`	Job class with constructor promotion
`lucid-qjob`	Queueable Job class (`implements ShouldQueue`)
`lucid-feature`	Feature class with `handle(Request $request)`
`lucid-operation`	Operation class with constructor promotion
`lucid-run`	`$this->run(new JobName(...))` call

Status Bar

Shows the detected project mode in the bottom-right corner:

⊞ Lucid: Micro    or    ⊞ Lucid: Monolith

Requirements

VS Code ^1.85.0
A Laravel project with lucidarch/lucid installed via Composer (vendor/lucidarch/lucid must exist)

The make/delete/init commands require a working vendor/bin/lucid binary. The tree view and CodeLens work without it.

Extension Settings

Setting	Default	Description
`lucid.binaryPath`	`""`	Custom path to the Lucid CLI binary. Leave empty to use `./vendor/bin/lucid`.
`lucid.mode`	`"auto"`	Override mode detection: `"auto"`, `"micro"`, or `"monolith"`.
`lucid.showCodeLens`	`true`	Show inline `->run()` navigation links.
`lucid.treeView.showTestFiles`	`false`	Show test file nodes in the tree view.

Project Structure Support

The extension mirrors the directory conventions from Finder.php exactly:

Unit	Micro	Monolith
Features	`app/Features/`	`app/Services/*/Features/`
Jobs	`app/Domains/*/Jobs/`	`app/Domains/*/Jobs/`
Operations	`app/Operations/`	`app/Services/*/Operations/`
Services	—	`app/Services/*/`
Domains	`app/Domains/*/`	`app/Domains/*/`

Contributing

git clone https://github.com/lucidarch/vscode-lucid
cd vscode-lucid
npm install

# Open in VS Code and press F5 to launch the Extension Development Host
code .

Bug reports and pull requests are welcome at github.com/lucidarch/vscode-lucid.

Lucid Architecture

Lucidarch

Lucid Architecture for VS Code

Features

Make Commands

Explorer Tree View

CodeLens on `->run()` Calls

Snippets

Status Bar

Requirements

Extension Settings

Project Structure Support

Contributing

License

Lucid Architecture

Lucidarch

Lucid Architecture for VS Code

Features

Make Commands

Explorer Tree View

CodeLens on ->run() Calls

Snippets

Status Bar

Requirements

Extension Settings

Project Structure Support

Contributing

License

CodeLens on `->run()` Calls