this is a 3d-printable case designed for the PinePhone,
but implemented with an eye towards generalizing beyond just that model
and supporting future phones/preferences alongside this first model.

as an example, the default case (pictured below) includes a pouch for carrying an external battery: a quick solution to achieve all-day battery life with any of the stock OSes. the back of this case prints flat, with a mesh that stretches to fit the battery upon installation.


## Images

![front view](readme_files/pinephone_front_case_with_phone.png)
![side view](readme_files/pinephone_side_case_with_phone.png)
![back view](readme_files/pinephone_back_case_with_phone.png)

![back view with battery](readme_files/pinephone_irl_back.jpg)
![side view with battery](readme_files/pinephone_irl_side.jpg)
![phone in hand](readme_files/pinephone_irl_front.jpg)

for an interactive viewer, see [build/web-viewer/index.html](https://git.uninsane.org/colin/phone-case-cq/raw/branch/docs-dev/build/web-viewer/index.html).
you'll need a browser which supports webGL (e.g. chromium).


## Prerequisites
- run `nix develop` to enter a dev environment.
- or manually install these dependencies:
  - Python3
  - cadquery
  - cq-editor (for interactive viewing/development)

## Building

- `./cq_toplevel.py --export-stl model.stl`

## Development
- `./cq_toplevel.py --editor` or `cq-editor ./cq_toplevel.py` to load an interactive GUI
  - press the green play button to render the model
  - call with `--render-phone` to see how the phone would fit inside the case

- CadQuery docs may be found here: <https://cadquery.readthedocs.io/en/latest/quickstart.html>