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.

Validate your extension

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.

Publish your extension

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 run

npx @raycast/api@latest 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.

Alternative way

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.

Waiting for review

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.

Share your extension

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.

🚀 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 updated