--- title: About Hardware slug: one/hardware/about docTags: createdAt: 2026-06-10T18:09:43.959Z --- This page explains the structure of the Hardware sub-project, provides links to its resources, and outlines how to contribute to Flipper One's electrical hardware development. ![About Hardware](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/fzLWa-3k9qma0wbtcHf_4_about-hardware-main.png) The Hardware sub-project covers electrical hardware development: printed circuit boards (PCBs), antennas, schematics, and everything related to the electrical connections of chips, connectors, and processors. The Hardware team works closely with the Mechanics team to ensure the electronics are compatible with the enclosure. The Hardware sub-project consists of: - βœ… [Task tracker](https://github.com/orgs/flipperdevices/projects/9) - ⚑ [Design files on Altium 365](https://flipper.365.altium.com/designs/folder-A78C8D02-EA07-49E1-AC7A-E84FAA2AF410) - πŸ“ [GitHub repository](https://github.com/flipperdevices/flipperone-hardware) - πŸ“š Docs: - πŸ”Œ **Hardware section** (you're here) - [πŸ§ͺ Testing section](docId\:RWUshMM2He49ls6jry8ZN) We'd love your feedback β€” look for tasks tagged **help wanted** in the task tracker, share your ideas in the comments, or contribute directly to the docs. ![Hardware sub-project structure](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/uWXgLshedoA2DXe01L1PV_hardware-sub-project-structure.jpg) *** ## βœ… Tasks tracker All Hardware team tasks are tracked in the GitHub project [Flipper One β€” Hardware](https://github.com/orgs/flipperdevices/projects/9). There, you can see what the engineering team is working on and follow progress and discussions. ![Hardware board explainer](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/Wx_eNFLs3-IzoFKMCnDQE_docs-board-explainer.png) **Some tasks are open** to the community and marked with a **help wanted** label. You're welcome to join the discussion on these tasks or submit your design proposals β€” just make sure to read the [Contribution guide](docId\:ZvY5s9jsZz1V92uwER9Da) first. *** ## ⚑ Design files on Altium 365 Selected parts of Flipper One's electrical design β€” schematics, PCB layouts, and BOM β€” are hosted on [Altium 365](https://flipper.365.altium.com/designs/folder-A78C8D02-EA07-49E1-AC7A-E84FAA2AF410), the cloud collaboration platform for circuit design. Altium 365 hosts the latest version of the shared design files; you can view them in your browser without installing any software. ![Altium 365 Web Viewer interface](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/zorHbPPKtNj3s4hA_4Z7x_altium-ui-general.png "Altium 365 Web Viewer interface") Click any project in the Flipper One folder to open it in the Web Viewer. Five view tabs are available along the top: - **SCH** β€” schematic - **PCB** β€” 2D layout - **3D** β€” interactive 3D render - **Draftsman** β€” fabrication documentation - **BOM** β€” Bill of Materials *** ### How to view the design files The Altium 365 Web Viewer lets you browse the project directly in your browser β€” no Altium Designer install required. ::::WorkflowBlock :::WorkflowBlockItem **Open the Flipper One folder.** Go to [Flipper One on Altium 365](https://flipper.365.altium.com/designs/folder-A78C8D02-EA07-49E1-AC7A-E84FAA2AF410). ::: :::WorkflowBlockItem **Sign in with your Altium or Google account.** If you don't have an Altium account, create one β€” it's free for viewing shared projects. ![Altium 365 sign-in](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/cd4UN_-Z1qYFY9ypQ5ZUb_altium-ui-login.png) ::: :::WorkflowBlockItem **Open a project.** Click the project you want to inspect. ::: :::WorkflowBlockItem **Switch between views.** Use the tabs at the top of the viewer to move between SCH, PCB, 3D, Draftsman, and BOM. ![Altium 365 open project β€” schematic view](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/6b1fnYkTxofJUWCnWMiE7_altium-ui-view.png) ::: :::WorkflowBlockItem **Inspect components and nets.** All views support pan and zoom, plus search and cross-probing β€” click a component on the schematic to highlight it on the PCB, or select a net to trace it across the design. ::: :::: *** ### How to export the design files The Web Viewer includes a download control whose available formats depend on the view you're in. From the schematic, PCB, or BOM views you can download a copy of the document for offline reference. ![Altium 365 Web Viewer download control](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/n5xRUMQBylDyvZfWrhNOR_altium-ui-download.png) The Web Viewer can export the entire project or individual derived files for offline reference. ::::WorkflowBlock :::WorkflowBlockItem **Open a project and click the Downloads icon** in the top-right of the viewer. A panel opens with Project Source Files and Derived Files sections. ::: :::WorkflowBlockItem **Download the whole project.** In Project Source Files, click the project entry to download all source files as a single archive. or **Download individual files.** In Derived Files, pick what you need β€” Gerber, Assembly Docs, PDF Schematic, STEP, or BOM. ::: :::: For full info about the download feature, see Altium's [official Web Viewer documentation](https://www.altium.com/documentation/altium-365/viewers/web-viewer#downloading). *** ## πŸ“š Docs Hardware documentation is split across two sections: - πŸ”Œ **Hardware section** (you're here) β€” port pinouts, modules, and subsystem references (Wi-Fi & Bluetooth, power, M.2, GPIO). - [πŸ§ͺ Testing section](docId\:RWUshMM2He49ls6jry8ZN) β€” hardware verification procedures for each subsystem. *** ## How to contribute The Hardware sub-project accepts contributions in two forms: **comments on open tasks** for ideas, suggestions, and improvements, and **edits to the docs** for documenting hardware experiments, findings, or external module designs. *** ### Suggest your change as a comment on an open task :::hint{type="info"} **⚠️ Contributions only β€” no flooding** To keep collaboration productive, please keep comments on-topic. Open tasks are for contribution-related discussion only. If you have an idea or concern, first turn it into a concrete contribution and share it as a comment on a task. For general questions or discussions, you're always welcome to join the conversation on [socialΒ media](https://x.com/Flipper_RND) or [Discord](https://discord.com/invite/flipper)! ::: ![Contribute a comment on an open task](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/P_-6VhryApc62b3fbc4-S_contribute-a-comment.jpg) Open tasks that need the community's help are labeled **help wanted**. If you have ideas on how to improve the design, you can contribute by commenting on the task and attaching screenshots, schematics, or links: ::::WorkflowBlock :::WorkflowBlockItem **Pick a task.** In the [Hardware GitHub project](https://github.com/orgs/flipperdevices/projects/9), browse the open tasks and click the one labeled **help wanted** that you want to contribute to. ::: :::WorkflowBlockItem **Write your suggestion.** In the comments section, clearly describe your suggestion and attach a screenshot, schematic snippet, or a link to your design on Altium 365. Ensure your design is accessible for others to view. ![Good vs bad comment on a Hardware task](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/7P5f3QhR3h-dqFuE-uJ1g_docs-good-vs-bad-comment.png) Attachment size limit: - Images: 10 MB - Videos: 100 MB ::: :::WorkflowBlockItem **Click Comment** to submit. ::: :::: We review all comments carefully! We may ask additional questions about your idea in the task thread, so please watch for GitHub notifications in your email. *** ### Contribute to the docs If you've spotted an error in the Hardware section, want to clarify something, or want to share your hardware experiments and findings, you're welcome to contribute by editing the docs. The fastest way to jump straight to a page's source is the **Edit on GitHub** button on the live site β€” it opens the page's `.md` file directly in the GitHub editor. ![Contribute to the Hardware docs](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/KoTgb2tzCAHr_6ZzuWb8s_hardware-contribute-to-docs.jpg) For a longer change, fork the repository, make your edits on a new branch, and open a pull request: ::::WorkflowBlock :::WorkflowBlockItem **Read the **[Markup reference](docId\:L8V_N7C30UTmEEIh2vl-7) to learn the supported Markdown and Archbee syntax. ::: :::WorkflowBlockItem **Fork the repository.** Go to [flipperone-docs](https://github.com/flipperdevices/flipperone-docs) and click **Fork** in the upper-right corner. Your fork opens on the `public-release` branch β€” the production branch connected to the live site. All your work happens here. ::: :::WorkflowBlockItem **Edit or create your **`.md`** file.** In your fork, find the file you want to edit under `docs/hardware/`, or create a new one in the appropriate subfolder. Follow the syntax shown on the Markup example page β€” some Markdown features behave differently in Archbee. ::: :::WorkflowBlockItem **(Optional) Add images.** If your change includes images, diagrams, or screenshots, upload them to `docs/files/pics/` and reference them with a relative path: ```markdown ![Alt text](/files/pics/your-image.png "Caption") ``` Use descriptive, lowercase filenames with hyphens (e.g. `gpio-pinout.png`). Keep images under 1 MB. ::: :::WorkflowBlockItem **(Optional) Register the new page in **[archbee.json](https://github.com/flipperdevices/flipperone-docs/blob/public-release/archbee.json)**.** Place it in the sidebar hierarchy (no deeper than two levels) β€” see [How archbee.json works](docId:5qbNeaaFeDvyK2XIS_-Zv) for the syntax. It's okay to skip β€” we'll update the file after merging your PR. ::: :::WorkflowBlockItem **Create a branch and commit.** Name the branch `nickname/what-changed` (e.g. `john/gpio-module-experiment`). Keep commit messages concise β€” e.g. `Add: GPIO module pinout reference`. ::: :::WorkflowBlockItem **Open a pull request from your branch to the original repository.** The target is pre-selected to `public-release` β€” leave it as is. Add a clear title and description, and ideally attach screenshots and a link to the related open task. Make sure **Allow edits by maintainers** is ticked so we can apply small wording or syntax fixes directly to your PR. Once merged, Archbee publishes your changes to the live site. ::: :::: Once your pull request is merged into `public-release`, Archbee automatically picks up the changes and rebuilds the live site at [docs.flipper.net/one](https://docs.flipper.net/one).