first push

Readme.md

@@ -0,0 +1,76 @@
+# Atari & Firebee Shopping Trolley Key (Multi-Material)
+
+A high-quality, ergonomic shopping trolley chip (23mm diameter) featuring the iconic **Atari** and **Firebee** logos. This project is specifically designed for multi-material 3D printers like the **Flashforge Adventurer 5M Pro (AD5X)** or printers equipped with an AMS/MMU.
+
+## 🚀 Overview
+
+This OpenSCAD project generates a "key-style" trolley chip. Unlike a simple round coin, this design includes a 45mm handle for easy insertion and removal from trolley slots. It supports up to **4 different colors** in a single print.
+
+### Features
+- **Front Side:** Deep-engraved Atari Logo.
+- **Back Side:** Deep-engraved Firebee Logo.
+- **Handle:** Customized "logo_text.svg" inlay and a 5mm keychain hole.
+- **Parametric Design:** Fully adjustable via OpenSCAD.
+- **Optimized for AD5X:** Designed to be printed with the first layer facing the bed for a perfectly smooth logo finish.
+
+---
+
+## 🛠 Print Settings (Optimized for 0.4mm Nozzle)
+
+To achieve the best results with the fine logo details, use the following settings:
+
+| Parameter | Recommended Value |
+| :--- | :--- |
+| **Layer Height** | 0.15mm (0.2mm for First Layer) |
+| **Wall Loops** | 4 (Important for handle strength) |
+| **Top/Bottom Shells** | 5 |
+| **Infill** | 30% (Gyroid or Honeycomb) |
+| **First Layer Speed** | 15–20 mm/s (Slow is critical for inlays) |
+| **Z-Hop** | 0.4mm |
+| **Prime Tower** | Enabled (Prevents color bleeding) |
+
+---
+
+## 📖 How to Use
+
+### 1. Preparation
+Place your SVG files in the same folder as the `.scad` file:
+- `logo_atari.svg`
+- `logo_firebee.svg`
+- `logo_text.svg`
+
+### 2. Exporting STLs
+In OpenSCAD, use the `export_mode` variable to render and export the four individual parts:
+1. `chip` -> `base.stl` (The main body)
+2. `atari` -> `inlay_atari.stl`
+3. `firebee` -> `inlay_firebee.stl`
+4. `text` -> `inlay_text.stl`
+
+### 3. Slicing (Crucial Step)
+1. Import **all 4 STLs** into your slicer at once.
+2. When prompted: **"Load as a single object with multiple parts?"**, select **YES**.
+3. Ensure the parts are merged/grouped correctly in the object list.
+4. **Check the Preview:** Look at Layer 1. Ensure the slicer isn't "over-printing" the logos with the base color. The base should leave exact gaps for the inlays.
+
+### 4. Color Selection
+For maximum contrast, we recommend:
+- **Base:** Black or Dark Grey
+- **Atari Logo:** Red or White
+- **Firebee Logo:** Pink or Orange
+- **Handle Text:** Light Blue or Lime Green
+
+---
+
+## 📸 Screenshot Mode
+The code includes a built-in toggle for documentation. Set `show_screenshot_view = true;` in OpenSCAD to see a perfectly centered, side-by-side view of both the front and back of the key.
+
+---
+
+## 📜 License
+This project is licensed under **Creative Commons - Attribution - Non-Commercial - Share Alike (CC-BY-NC-SA)**.
+- **Attribution:** You must give appropriate credit.
+- **Non-Commercial:** You may not use the material for commercial purposes.
+- **ShareAlike:** If you remix, transform, or build upon the material, you must distribute your contributions under the same license.
+
+---
+*Created with OpenSCAD - Optimized for the Atari & Firebee community.*