esphome-docs icon indicating copy to clipboard operation
esphome-docs copied to clipboard

Update _index.md listing nRF52 as a first-class platform

Open Hedda opened this issue 3 months ago • 6 comments

Description:

Follow-up to PR https://github.com/esphome/esphome-docs/pull/5291 which only added a mentioning of "nRF52" under other microcontrollers (at the bottom of the website).

This new PR also add the nRF52 platform (Nordic Semi MCUs) to the description list at the very top of the main website/webpage.

i.e. "Turn your ESP32, ESP8266, nRF52, or RP2040 boards into powerful smart home devices with simple YAML configuration"

That is, if nRF52 is now a first-class platform, then it should probably be reflected there at the top as well.

ESPHome 2025.8.0 changelog said that it introduced comprehensive support for the nrf52 platform but if that still means that it is only ”experimental” then maybe do not list it at the top until later and thus do not yet merge this PR that change the listing(?).

"ESPHome 2025.8.0 introduces comprehensive support for Nordic nRF52 series microcontrollers ..."

For reference, initial support for nRF52 platform was added (by @tomaszduda23) to ESPHome 2025.8.0 release, see changelog:

  • https://esphome.io/changelog/2025.8.0/

    • https://esphome.io/changelog/2025.8.0/#nrf52-platform-support

ESPHome 2025.9.0 changelog said that it added ”Enhanced NRF52 features”:

  • https://esphome.io/changelog/2025.9.0/
image

Related issue (if applicable): fixes

Pull request in esphome with YAML changes (if applicable):

  • esphome/esphome#<esphome PR number goes here>

Checklist:

  • [ ] I am merging into next because this is new documentation that has a matching pull-request in esphome as linked above.
    or

  • [x] I am merging into current because this is a fix, change and/or adjustment in the current documentation and is not for a new component or feature.

  • [ ] Link added in /components/index.rst when creating new documents for new components or cookbook.

New Component Images

If you are adding a new component to ESPHome, you can automatically generate a standardized black and white component name image for the documentation.

To generate a component image:

  1. Comment on this pull request with the following command, replacing COMPONENT_NAME with your component name in UPPER_CASE format with underscores (e.g., BME280, SHT3X, DALLAS_TEMP):

    @esphomebot generate image COMPONENT_NAME
    
  2. The ESPHome bot will respond with a downloadable ZIP file containing the SVG image.

  3. Extract the SVG file and place it in the images/ folder of this repository.

  4. Use the image in your component's index table entry in /components/index.rst.

Example: For a component called "DHT22 Temperature Sensor", use:

@esphomebot generate image DHT22

Hedda avatar Aug 26 '25 06:08 Hedda

Deploy Preview for esphome ready!

Name Link
Latest commit d49947a95149b0e0aa8b5199d0b1d5b6cc0428c2
Latest deploy log https://app.netlify.com/projects/esphome/deploys/68ad573c52e3270008d49ee4
Deploy Preview https://deploy-preview-5292--esphome.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

netlify[bot] avatar Aug 26 '25 06:08 netlify[bot]

Walkthrough

Updates SEO description in content/_index.md to include nRF52 among supported microcontrollers. No other changes.

Changes

Cohort / File(s) Summary of Changes
Site content / SEO description
content/_index.md
Updated params.seo.description text to list ESP32, ESP8266, nRF52, and RP2040 instead of ESP32, ESP8266, and RP2040.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

  • esphome/esphome-docs#5291 — Also updates content/_index.md regarding nRF52 and suggests adding nRF52 to the top SEO/summary, matching this change.

Suggested labels

current

Suggested reviewers

  • jesserockz
  • clydebarrow

[!TIP]

🔌 Remote MCP (Model Context Protocol) integration is now available!

Pro plan users can now connect to remote MCP servers from the Integrations page. Connect with popular remote MCPs such as Notion and Linear to add more context to your reviews and chats.

✨ Finishing Touches
🧪 Generate unit tests
  • [ ] Create PR with unit tests
  • [ ] Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

coderabbitai[bot] avatar Aug 26 '25 06:08 coderabbitai[bot]

#5305

jesserockz avatar Aug 28 '25 22:08 jesserockz

There hasn't been any activity on this pull request recently. This pull request has been automatically marked as stale because of that and will be closed if no further activity occurs within 7 days. Thank you for your contributions.

github-actions[bot] avatar Dec 06 '25 02:12 github-actions[bot]

What is missing for the nRF52 platform (for MCUs like nRF52840) to be listed as a first-class platform?

  • OTA support?

Hedda avatar Dec 06 '25 08:12 Hedda

Ota is there https://github.com/esphome/esphome/pull/11932. I would say zigbee and Ota.

tomaszduda23 avatar Dec 06 '25 09:12 tomaszduda23