whatisgithub

What is auto-battery-frame-generator?

ebteam3/auto-battery-frame-generator — explained in plain English

Analysis updated 2026-05-18

5HTMLAudience · vibe coderComplexity · 2/5Setup · easy

In one sentence

A single offline HTML tool that lets you design and export custom 3D-printable or CAD battery cell frames for 21700 cells.

Mindmap

mindmap
  root((Battery Frame Generator))
    What it does
      Designs battery cell frames
      Exports STEP and STL
      Offline single HTML file
    Tech stack
      JavaScript
      Three.js viewer
      WebAssembly CAD kernel
      esbuild bundler
    Use cases
      3D printed battery holders
      Custom pack design
      Spot welded tab access
    Audience
      Hobbyist makers
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Design a custom battery cell holder frame for a 21700 spot-welded battery pack.

USE CASE 2

Export STEP or STL files of a battery frame for 3D printing or CAD editing.

USE CASE 3

Preview a battery frame design in 3D directly in the browser with no installation.

What is it built with?

JavaScriptThree.jsWebAssemblyesbuild

How does it compare?

ebteam3/auto-battery-frame-generatorczmanix/pebble-color-optimizergskinnerteam/color_swirl
Stars555
LanguageHTMLHTMLHTML
Last pushed2015-09-06
MaintenanceDormant
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencevibe coderdeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Rebuilding from source requires Node.js, using the tool itself just needs opening the HTML file.

No license information is provided in the repository.

So what is it?

This is a single self contained web page that lets someone design and export a physical frame for holding battery cells together, specifically for the common 21700 size cells used in spot welded battery packs. Instead of using traditional CAD software, you open one HTML file directly in a browser like Chrome or Edge, with no installation and no internet connection needed, since the 3D modeling engine is built right into the file itself. To design a frame, you click and drag on a grid of circles to place where each battery cell goes, choose whether they should be arranged in a square or triangular pattern, and pick whether the outline should have straight sides or hug tightly around each cell. You can then adjust precise measurements such as the spacing between cells, the size of each cell's hole, the wall height, and how much material surrounds the outermost cells. A live 3D preview updates as you change these settings, showing the overall size of the finished frame, and you can rotate the view with your mouse. Each hole is designed with a small ledge inside so the battery rests on a lip while still leaving an opening underneath for the metal tabs used in spot welding to reach through. Once satisfied with the design, you export it as a STEP file or an STL file, both standard formats that 3D printers and other CAD tools can use directly. The interface itself uses a modern looking style with translucent panels over a soft moving background, supports both light and dark themes, and can expand either the design grid or the 3D preview to fill the whole screen. For anyone who wants to modify the underlying code rather than just use the finished tool, the project can also be rebuilt from source using Node.js, and it includes its own set of automated tests that check the generated 3D geometry for correctness.

Copy-paste prompts

Prompt 1
Walk me through opening this Battery Frame Generator HTML file and designing a frame for a 4 by 4 grid of cells.
Prompt 2
Explain what the retention base and outer wall parameters control in the frame design.
Prompt 3
How do I rebuild this project from source using Node.js and esbuild?
Prompt 4
Show me how to run the CAD tests like face-census and lip-verify for this project.

Frequently asked questions

What is auto-battery-frame-generator?

A single offline HTML tool that lets you design and export custom 3D-printable or CAD battery cell frames for 21700 cells.

What language is auto-battery-frame-generator written in?

Mainly HTML. The stack also includes JavaScript, Three.js, WebAssembly.

What license does auto-battery-frame-generator use?

No license information is provided in the repository.

How hard is auto-battery-frame-generator to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is auto-battery-frame-generator for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.