All pages
Powered by GitBook
1 of 1

Loading...

Create Your First Extension

Learn how to build your first extension and use it in Raycast.

Create a new extension

Open the Create Extension command, name your extension "Hello World" and select the "Detail" template. Pick a parent folder in the Location field and press ⌘ ↵ to continue.

Create Extension command in Raycast

To create a private extension, select your organization in the first dropdown. You need to be logged in and part of an organization to see the dropdown. Learn more about Raycast for Teams .

To kickstart your extensions, Raycast provides various templates for commands and tools. Learn more .

Next, you'll need to follow the on-screen instructions to build the extension.

Build the extension

Open your terminal, navigate to your extension directory and run npm install && npm run dev. Open Raycast, and you'll notice your extension at the top of the root search. Press ↵ to open it.

Develop your extension

To make changes to your extension, open the ./src/index.tsx file in your extension directory, change the markdown text and save it. Then, open your command in Raycast again and see your changes.

npm run dev starts the extension in development mode with hot reloading, error reporting and .

Use your extension

Now, you can press ⌃ C in your terminal to stop npm run dev. The extension stays in Raycast, and you can find its commands in the root when searching for the extension name "Hello World" or the command name "Render Markdown".

🎉 Congratulations! You built your first extension. Off to many more.

Don't forget to run again when you want to change something in your extension.

here
here
more
npm run dev
Your first extension
Find your extension in the root search