Awesome Framework

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

Disclaimer - Please read!
Expansion Cards
Mainboard Enclosures
Embedded Controller Firmware Mods
Linux Support
Accessories
Hardware Support
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.
Spacehuhn
- ESP32-S3 GitHub and Store - An ESP32-S3 development board with Neopixel RGB LED and a QWIIC/Stemma QT connector.

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.
Official Battery Life Instructions - Instructions for increasing battery life on Framework Laptop running Ubuntu. Should be able to be applied to other distros.
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.
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.

framewiki/awesome-framework