Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 25 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,37 @@
# Serverless Navigator

VS Code extension that adds smart navigation to `serverless.yml` files. Handler values become clickable links that open the referenced source file and jump straight to the exported function. Schema references using `${file(...)}` also become navigable links to the JSON schema file.
[![CI](https://github.com/andreluizweb/serverless-navigator/actions/workflows/ci.yml/badge.svg)](https://github.com/andreluizweb/serverless-navigator/actions/workflows/ci.yml)
[![VS Code Marketplace Version](https://img.shields.io/visual-studio-marketplace/v/andreluizbatista.serverless-navigator)](https://marketplace.visualstudio.com/items?itemName=andreluizbatista.serverless-navigator)
[![VS Code Marketplace Installs](https://img.shields.io/visual-studio-marketplace/i/andreluizbatista.serverless-navigator)](https://marketplace.visualstudio.com/items?itemName=andreluizbatista.serverless-navigator)
[![Open VSX Version](https://img.shields.io/open-vsx/v/andreluizbatista/serverless-navigator)](https://open-vsx.org/extension/andreluizbatista/serverless-navigator)

![Demo](src/assets/demo.gif)
VS Code extension that adds smart navigation to `serverless.yml` files. Handler values become clickable links that open the referenced source file and jump straight to the exported function. Schema references using `${file(...)}` also become navigable links to the JSON schema file.

## Features

- **Clickable links** on `handler:` values — jump to the file and exported function
- **Clickable links** on `schema: ${file(...)}` — open the JSON schema directly
- **CodeLens buttons** above handler and schema lines for quick navigation
- **Variable resolution** — supports `${self:...}`, `${opt:...}`, `${env:...}`
- **Monorepo support** — resolves paths relative to both `serverless.yml` and workspace root
- **Zero runtime dependencies** — lightweight and fast
### Handler Navigation

Bidirectional navigation between `serverless.yml` and handler functions — click a handler value to jump to the source file, or use the CodeLens above a function to navigate back to its definition in `serverless.yml`.

![Handler Navigation](src/assets/link-handler-function.gif)

### Schema Navigation

## How it works
Clickable links on `schema: ${file(...)}` references — open the JSON schema file directly.

Open any `serverless.yml` or `serverless.yaml` file and you'll see:
![Schema Navigation](src/assets/link-schema.gif)

1. Handler values are underlined and clickable — clicking navigates to the source file and positions the cursor at the exported function
2. CodeLens buttons appear above each handler line showing the file path and export name
3. Schema `${file(...)}` references are clickable links to the JSON schema file
### CloudWatch Log Insights

CodeLens button to open CloudWatch Log Insights filtered by the Lambda function's log group. On first use, you can pick an existing stage or enter a custom one — your selection is saved for future queries.

![CloudWatch Log Insights](src/assets/cloudwatch.gif)

### More

- **Variable resolution** — supports `${self:...}`, `${opt:...}`, `${env:...}`
- **Monorepo support** — resolves paths relative to both `serverless.yml` and workspace root
- **Zero runtime dependencies** — lightweight and fast

## Supported patterns

Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "serverless-navigator",
"displayName": "Serverless Navigator",
"description": "Navigate from serverless.yml handler and schema definitions directly to source files and JSON schemas with clickable links and CodeLens.",
"version": "0.3.2",
"version": "0.3.3",
"publisher": "andreluizbatista",
"license": "MIT",
"icon": "src/assets/icon.png",
Expand Down
Binary file added src/assets/cloudwatch.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed src/assets/demo.gif
Binary file not shown.
Binary file added src/assets/link-handler-function.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/link-schema.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.