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
  • Chargers
  • Docking Stations
  • Cases and Sleeves
• 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.

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.

Expansion Cards

• Josh_Cook
  • UART GitHub and Store - Complete UART expansion card, available as pre-assembled from his store, or design files on GitHub.

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.
• DIY Perks "Triple-Screen Laptop DONE RIGHT!" - Custom triple-screen portable computer using Framework mainboard and battery.

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

Chargers

• Official Framework Power Adapter - Framework's first-party USB-PD charging adapter.
• Anker 65W Nano - Community validated single-port 65W PD charger.

Docking Stations

• Thunderbolt 4 Support - Official knowledgebase article on TB4 support.
• Anker 777 TB4 Docking Station - Community validated docking station with HDMI, USB-A, USB-C, SD and Audio. All I/O options work out-of-the-box on 12th gen Framework running Ubuntu 22.04.

Cases and Sleeves

• Case Logic Reflect 13" - Community tested laptop sleeve. Ensure you do NOT get the MacBook version as it will not fit.
• Tomtoc Laptop Shoulder Bag 13-13.5" - Community validated laptop case / shoulder bag.
• FINPAC Hard Case for 13" MacBook - Community validated hard laptop case.

Hardware Support

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.