Awesome Framework

A curated list of projects, tools, documentation and resources related to the Framework Laptop

Contents

• Disclaimer - Please read!
• Expansion Cards
• Mainboard Enclosures
• Embedded Controller Firmware Mods
• Linux Support
• Accessories
• Hardware Support
  • Storage
  • Memory
  • WiFi Cards
• Troubleshooting

Disclaimer

This repository and the resources within it are COMPLETELY UNOFFICIAL and not in any way endorsed or supported by Framework. Your use of these guides and projects is AT YOUR OWN RISK and MAY VOID YOUR WARRANTY. We ask that you do not reach out to Framework support about problems related to these resources, but you can feel free to reach out to the community maintainers via GitHub Discussions or Issues within this repository.

Expansion Cards

Mainboard Development

• Mainboard Reference - Physical and electrical reference for the Mainboard (and a 3D printable enclosure).
• WhatTheFilament
  • Framework-Motherboard-Reference-CAD - To-scale CAD reference of the Mainboard.
  • Frame-WorkStation - Desktop enclosure.
  • Framework-Desktop-Adapter - ATX mount adapter.
  • Framework-Tablet - Tablet conversion case.
  • FrameStation - Game console enclosure.
  • Framework-Test-Bench - Development/Test bench.

Embedded Controller Firmware Mods

• DHowett (AKA The EC Guy)
  • Hacking your Framework Laptop’s EC for fun and profit - Great place to start hacking your EC.
  • ECTool.EFI - EFI Shell application for flashing the EC.
• EC Firmware Source Code

Linux Support

• Distro List - List of officially supported distros and links to their setup guides.
• Arch Wiki - The arch wiki entry for the Framework Laptop.
• LinuxLaptops Wiki - Wiki article with a ton of useful information specific to linux on the framework laptop.
• Linux Battery Life Forum Thread - This will be replaced (soon) by a page in this repo since this is outdated and (in some places) incorrect.
• Common Problems - A collection of common issues with running Linux on the Framework laptop and their solutions.

Accessories

Hardware Support

Note

Parts listed as community validated are not on Framework's list of officially supported parts. While they have been tested by members of the community, there is no guarantee that they will work for you. Additionally, no guarantees of any kind are made about the sellers linked.

Storage

• Officially Validated SSD List
• SK Hynix Gold P31 - Community validated SSD. Available in 500GB, 1TB and 2TB sizes.
• Crucial P2 - Community validated SSD. Available in 256GB, 500GB, 1TB and 2TB.

Memory

• Officially Validated DRAM List
• Crucial CT2K16G4SFD832A - Community validated DDR4-3200 CL22 RAM. Available in 32GB (2x16GB) kits.
• SK Hynix HMAA1GS6CJR6N - Community validated DDR4-3200 RAM. Available in 8GB (1x8GB) kits.
• SK Hynix HMA851S6CJR6N - Community validateed DDR4-3200 RAM. Available in 4GB (1x4GB) kits.

WiFi Cards

• Officially Validated Wifi Card List

Troubleshooting

Community

• Framework Forums
• Framework Discord
• Framework Subreddit

Contributing

This list's Contribution Guidelines can be found here.