| description |
|---|
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.
{% hint style="info" %}
npm run build validates your extension for distribution without publishing it to the store. Read more about it here.
{% endhint %}
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.
{% hint style="info" %}
If someone contributes to your extension, running npm run publish will fail until you run
npx @raycast/api@latest pull-contributionsin your git repository. This will merge the contributions with your code, asking you to fix the conflicts if any. {% endhint %}
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.
{% hint style="info" %} We're still figuring things out and updating our guidelines. If something is unclear, please tell us in our community. {% endhint %}
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.