docs: adding new LS Toolkit doc changes

astro.config.mjs

@@ -329,35 +329,39 @@ export default defineConfig({
                   collapsed: true,
                 },
                 {
-                  label: 'Testing Utils',
-                  slug: 'aws/tooling/testing-utils',
+                  label: 'LocalStack Toolkit VS Code',
+                  slug: 'aws/tooling/vscode-extension',
                 },
                 {
-                  label: 'LocalSurf',
-                  slug: 'aws/tooling/localsurf',
-                },
-                {
-                  label: 'AWS Replicator',
-                  slug: 'aws/tooling/aws-replicator',
+                  label: 'Lambda Tools',
+                  autogenerate: {
+                    directory: '/aws/tooling/lambda-tools',
+                  },
+                  collapsed: true,
                 },
                 {
                   label: 'Event Studio',
                   slug: 'aws/tooling/event-studio',
                 },
+                {
+                  label: 'AWS Replicator',
+                  slug: 'aws/tooling/aws-replicator',
+                },
                 {
                   label: 'DNS Server',
                   slug: 'aws/tooling/dns-server',
                 },
+                {
+                  label: 'Testing Utils',
+                  slug: 'aws/tooling/testing-utils',
+                },
                 {
                   label: 'LocalStack Docker Extension',
                   slug: 'aws/tooling/localstack-docker-extension',
                 },
                 {
-                  label: 'Lambda Tools',
-                  autogenerate: {
-                    directory: '/aws/tooling/lambda-tools',
-                  },
-                  collapsed: true,
+                  label: 'LocalSurf',
+                  slug: 'aws/tooling/localsurf',
                 },
               ],
             },

scripts/redirects/_redirects

@@ -134,7 +134,7 @@
 /applications/temp/ /aws/sample-apps/ 301
 /applications/serverless-container-based-apis-with-amazon-ecs-api-gateway/ https://github.com/localstack-samples/sample-terraform-ecs-apigateway 301
 /user-guide/aws/s3/ /aws/services/s3 301
-/user-guide/lambda-tools/vscode-extension/ /aws/tooling/lambda-tools/vscode-extension 301
+/user-guide/lambda-tools/vscode-extension/ /aws/tooling/vscode-extension 301
 /user-guide/chaos-engineering/ /aws/capabilities/chaos-engineering/ 301
 /persistence/supported/ /aws/capabilities/state-management/persistence-coverage 301
 /user-guide/aws/ce/ /aws/services/ce 301
@@ -406,4 +406,4 @@
 /user-guide/extensions/managing-extensions/ /aws/tooling/extensions/managing-extensions 301
 /references/filesystem/ /aws/capabilities/config/filesystem/ 301
 /references/ /aws/capabilities/config/ 301
-/academy/localstack-101/getting-started/ https://www.youtube.com/watch?v=CzX4mfiS058&feature=youtu.be 301
+/academy/localstack-101/getting-started/ https://www.youtube.com/watch?v=CzX4mfiS058&feature=youtu.be 301

src/content/docs/aws/services/lambda.mdx

@@ -531,7 +531,7 @@ LocalStack provides various tools to help you develop, debug, and test your AWS
 - **Remote debugging**: LocalStack's remote debugging functionality allows you to attach a debugger to your Lambda function using your preferred IDE.
   To get started with remote debugging in LocalStack, see our [debugging documentation](/aws/tooling/lambda-tools/remote-debugging).
 - **Lambda VS Code Extension**: LocalStack's Lambda VS Code Extension supports deploying and invoking Python Lambda functions through AWS SAM or AWS CloudFormation.
-  To get started with the Lambda VS Code Extension, see our [Lambda VS Code Extension documentation](/aws/tooling/lambda-tools/vscode-extension).
+  To get started with the Lambda VS Code Extension, see our [Lambda VS Code Extension documentation](/aws/tooling/vscode-extension).
 - **API for querying Lambda runtimes**: LocalStack offers a metadata API to query the list of Lambda runtimes via `GET http://localhost.localstack.cloud:4566/_aws/lambda/runtimes`.
   It returns the [Supported Runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) matching AWS parity (i.e., excluding deprecated runtimes) and offers additional filters for `deprecated` runtimes and `all` runtimes (`GET /_aws/lambda/runtimes?filter=all`).
 
@@ -726,4 +726,4 @@ You might encounter this error if it is set to `legacy`.
 
 ## API Coverage
 
-<FeatureCoverage service="lambda" client:load />
+<FeatureCoverage service="lambda" client:load />

src/content/docs/aws/tooling/lambda-tools/index.md

@@ -10,8 +10,8 @@ LocalStack’s Lambda Tools offer a set of utilities to streamline the local dev
 
 These tools are designed to shorten feedback loops and improve the developer experience with features like:
 
-- **IDE debugging**: Attach a debugger to your running Lambda function, set breakpoints, inspect variables, and step through code
+- **IDE debugging**: Attach a debugger to your running Lambda function, set breakpoints, inspect variables, and step through code.
 
-- **Hot reload**: Automatically apply code changes without needing to redeploy the function, enabling rapid iteration
+- **Hot reload**: Automatically apply code changes without needing to redeploy the function, enabling rapid iteration.
 
-- **VSCode integration**: Use the LocalStack VSCode extension to deploy and invoke Lambda functions directly from your editor using SAM or CloudFormation templates.
+- **LocalStack Toolkit for VSCode**: The [LocalStack Toolkit for VS Code](https://github.com/localstack/localstack-vscode-extension) enables you to install, configure, and run LocalStack without leaving VS Code.

src/content/docs/aws/tooling/vscode-extension.md

@@ -0,0 +1,88 @@
+---
+title: LocalStack Toolkit for VS Code
+description: Install, configure, and run LocalStack without leaving VS Code.
+template: doc
+tags: ["Free"]
+---
+
+## Introduction 
+
+The [LocalStack Toolkit for VS Code](https://github.com/localstack/localstack-toolkit-vscode) enables you to install, configure, and run LocalStack without leaving VS Code.
+
+## Prerequisites
+
+- [VS Code](https://code.visualstudio.com/)
+
+
+## Install and configure LocalStack
+
+The setup wizard ensures LocalStack is installed and configured for a seamless integration with AWS tools, like the AWS CLI, SDKs, AWS SAM or the AWS CDK.
+
+LocalStack can be installed either locally for the current user or globally for all users.
+
+You can [start using LocalStack for free by signing up for a free account](https://app.localstack.cloud/sign-up?plan=free) or signing into an existing one. The setup wizard facilitates this process and configures your authentication token required to start LocalStack.
+
+The LocalStack Toolkit integrates seamlessly with AWS tools like the [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html). It automatically configures a dedicated `localstack` AWS profile in your `.aws/config` and `.aws/credentials` files, if one is not already present.
+
+![Installing LocalStack Toolkit](/images/aws/localstack-toolkit/starting-localstack.png)
+
+
+## Run LocalStack
+
+The LocalStack button in the VS Code status bar provides an instant view of LocalStack's runtime status, such as `stopped` or `running`.
+
+![LocalStack Toolkit Running](/images/aws/localstack-toolkit/running.png)
+
+The status bar button provides access to `Start` and `Stop` LocalStack commands. The status button turns red if LocalStack is not found or misconfigured. You can also open the LocalStack log view from here.
+
+![Stop LocalStack Toolkit](/images/aws/localstack-toolkit/stop-localstack.png)
+
+## Viewing LocalStack logs
+
+You can see LocalStack logs in the VS Code Output panel. Simply select LocalStack from the drop-down menu.
+
+![LocalStack Toolkit Logs](/images/aws/localstack-toolkit/logs.png)
+
+
+## `localstack` AWS profile
+
+Once the profile is configured you can use it from your favorite AWS tools like AWS CLI, SDKs, CDK to deploy to and interact with LocalStack.
+
+For example, to list SQS queues using the AWS CLI and your `localstack` profile:
+
+```bash
+aws --profile localstack sqs list-queues
+```
+
+
+## LocalStack Commands Table
+
+| ID                                | Title                                | Menu Contexts    |
+|-----------------------------------|--------------------------------------|------------------|
+| `localstack.configureAwsProfiles` | Configure AWS Profile "localstack"  | `commandPalette` |
+| `localstack.setup`                | Run Setup Wizard                     | `commandPalette` |
+| `localstack.start`                | Start LocalStack                     | `commandPalette` |
+| `localstack.stop`                 | Stop LocalStack                      | `commandPalette` |
+| `localstack.viewLogs`             | View Logs                            | `commandPalette` |
+
+
+:::note
+The AWS Toolkit for VS Code, a separate VS Code extension available from Amazon, now provides the ability to connect with LocalStack. This automates much of the existing manual setup required to debug Lambda functions (https://docs.localstack.cloud/aws/tooling/lambda-tools/remote-debugging/).
+:::
+
+## Contributing
+
+[Read our contributing guidelines](./CONTRIBUTING.md) to learn how you can help.
+
+
+### LocalStack Toolkit for VS Code extension support
+
+Please provide feedback or report an issue on the LocalStack Toolkit for VS Code by using our [GitHub Issues](https://github.com/localstack/localstack-toolkit-vscode/issues) page.
+
+### LocalStack general support
+
+For LocalStack-related questions, feedback, and contributions, you can:
+
+- Check our main repository: visit our [get in touch section on LocalStack's GitHub](https://github.com/localstack/localstack?tab=readme-ov-file#get-in-touch) for contact information and support channels.
+
+- Join our Slack Community: Connect with other developers on the official [LocalStack Slack community](https://localstack.cloud/slack).