Publish an Extension
Learn how to share your extension with our community.
Before you publish your extension, take a look at how to prepare your extension for the Store. Making sure you follow the guidelines is the best way to help your extension pass the review.
Open your terminal, navigate to your extension directory, and run
npm run build
to verify your extension. The command should complete without any errors.npm run build
validates your extension for distribution without publishing it to the store. Read more about it here.To share your extension with others, navigate to your extension directory, and run
npm run publish
to publish your extension. You will be asked to authenticate with GitHub because the script will automatically open a pull request in our repository.If someone contributes to your extension, running
npm run publish
will fail until you runnpx @raycast/[email protected] pull-contributions
in your git repository. This will merge the contributions with your code, asking you to fix the conflicts if any.
Once the pull request is opened, you can continue pushing more commits to it by running
npm run publish
again.If you want more control over the publishing process, you can manually do what
npm run publish
does. You need to open a pull request in our repository. For this, fork our repository, add your extension to your fork, push your changes, and open a pull request via the GitHub web interface into our main
branch.After you opened a pull request, we'll review your extension and request changes when required. Once accepted, the pull request is merged and your extension will be automatically published to the Raycast Store.
We're still figuring things out and updating our guidelines. If something is unclear, please tell us in our community.
Once your extension is published in the Raycast Store, you can share it with our community. Open the Manage Extensions command, search for your extension and press
⌘
⌥
.
to copy the link.
Manage your extensions
🚀 Now it's time to share your work! Tweet about your extension, share it with our Slack community or send it to your teammates.
Last modified 1mo ago