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

Storage

• Officially Validated SSD List

Memory

• Officially Validated DRAM List

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.