From 865b02cf64be460eee9ecdfce05db0ee249c4a1e Mon Sep 17 00:00:00 2001 From: Preston Tamkin <845970+prestomation@users.noreply.github.com> Date: Sun, 21 Sep 2025 21:44:45 -0700 Subject: [PATCH] Improve documentation with information from David's videos --- astro.config.mjs | 11 ++ src/content/docs/community.mdx | 163 +++++++++++++++++++++ src/content/docs/compatibility.mdx | 103 +++++++++++++ src/content/docs/faq.mdx | 67 +++++++++ src/content/docs/guides/accessories.mdx | 50 ++++++- src/content/docs/guides/board.mdx | 108 ++++++++++++-- src/content/docs/guides/index.mdx | 18 ++- src/content/docs/guides/snaps.mdx | 10 ++ src/content/docs/maintenance.mdx | 120 +++++++++++++++ src/content/docs/projects/gridfinity.mdx | 131 ++++++++++++++++- src/content/docs/projects/multiconnect.mdx | 9 +- src/content/docs/projects/underware.mdx | 60 +++++++- src/content/docs/troubleshooting.mdx | 106 ++++++++++++++ src/content/docs/videos.mdx | 98 +++++++++++++ 14 files changed, 1023 insertions(+), 31 deletions(-) create mode 100644 src/content/docs/community.mdx create mode 100644 src/content/docs/compatibility.mdx create mode 100644 src/content/docs/faq.mdx create mode 100644 src/content/docs/maintenance.mdx create mode 100644 src/content/docs/troubleshooting.mdx create mode 100644 src/content/docs/videos.mdx diff --git a/astro.config.mjs b/astro.config.mjs index b413590..02804c2 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -33,6 +33,17 @@ export default defineConfig({ { label: 'NeoGrid', slug: 'projects/neogrid' }, ], }, + { + label: 'Resources', + items: [ + { label: 'FAQ', link: '/faq' }, + { label: 'Troubleshooting', link: '/troubleshooting' }, + { label: 'Compatibility', link: '/compatibility' }, + { label: 'Videos', link: '/videos' }, + { label: 'Community', link: '/community' }, + { label: 'Maintenance', link: '/maintenance' }, + ], + }, { label: 'Useful links', link: '/links' } ], }), diff --git a/src/content/docs/community.mdx b/src/content/docs/community.mdx new file mode 100644 index 0000000..55100b6 --- /dev/null +++ b/src/content/docs/community.mdx @@ -0,0 +1,163 @@ +--- +title: Community & Ecosystem +description: Community resources, contributions, and the growing openGrid ecosystem. +--- + +openGrid thrives as an open ecosystem where community contributions drive innovation and expand functionality. The CC-BY 4.0 license encourages both personal and commercial development. + +## Community Platforms + +### Printables +The primary hub for openGrid community content: + +**Core System:** +- [openGrid main collection](https://www.printables.com/model/1214361-opengrid-walldesk-mounting-framework-and-ecosystem) +- [openGrid M6 screw version](https://www.printables.com/model/1219888-opengrid-m6-screw-board-version) + +**Community Accessories:** +- [Holders and organizers](https://www.printables.com/search/models?q=tag:opengrid+holder) +- [Shelving solutions](https://www.printables.com/search/models?q=tag:opengrid+shelve) +- [Hooks and hangers](https://www.printables.com/search/models?q=tag:opengrid+hook) +- [Mounting solutions](https://www.printables.com/search/models?q=tag:opengrid+mount) +- [Multiconnect accessories](https://www.printables.com/search/models?q=tag:opengrid+multiconnect) + +### MakerWorld +Growing collection of openGrid content: + +**Official Models:** +- [openGrid system](https://makerworld.com/en/models/1179191-opengrid-wall-desk-mounting-framework-ecosystem) +- [Tile generator](https://makerworld.com/en/models/1304337-opengrid-tile-generator) +- [Underware integration](https://makerworld.com/en/models/1175037-underware-for-opengrid) + +**Community Content:** +- [Holders](https://makerworld.com/en/search/models?keyword=opengrid+holder) +- [Shelves](https://makerworld.com/en/search/models?keyword=opengrid+shelve) +- [Hooks](https://makerworld.com/en/search/models?keyword=opengrid+hook) +- [Mounts](https://makerworld.com/en/search/models?keyword=opengrid+mount) +- [Multiconnect](https://makerworld.com/en/search/models?keyword=opengrid+multiconnect) + +## Ecosystem Partners + +### Underware Integration +**by HandsOn Katie** +- Full compatibility with openGrid Lite boards +- Space-efficient cable management +- Generator support for custom configurations +- [Official Underware 2.0 collection](https://handsonkatie.com/underware-2-0-the-made-to-measure-collection/) + +### Multiconnect System +**by DavidD (openGrid creator)** +- Universal adapter system for multiple board types +- Extensive accessory library +- Cross-platform compatibility +- Enables use of existing accessories with openGrid + +### Gridfinity Compatibility +**Mathematical grid relationship enables:** +- Direct use of many Gridfinity accessories +- Shelving systems integration +- Storage solutions compatibility +- Community adaptations and modifications + +## Development Tools + +### Generators and Customizers +**openGrid Tile Generator:** +- [MakerWorld version](https://makerworld.com/en/models/1304337-opengrid-tile-generator) +- [Perplexing Labs version](https://gridfinity.perplexinglabs.com/pr/opengrid/0/0) +- Custom board sizes and features +- Specialized mounting options + +**Underware Generator:** +- [MakerWorld customizer](https://makerworld.com/en/models/1329404-underware-for-opengrid-customizer-beta) +- 28mm grid compatibility +- Custom channel configurations + +### Design Resources +**OpenSCAD Files:** +- Parametric design flexibility +- Community modification friendly +- Educational value for learning 3D design +- Base for derivative works + +## Contributing to the Ecosystem + +### Design Guidelines +**Living Room Compatibility:** +- Clean, minimal aesthetics +- Consistent color schemes +- Professional appearance + +**Functional Requirements:** +- 28mm grid compatibility +- Front-side access design +- Appropriate snap selection +- Load capacity considerations + +### Sharing Your Designs +**Recommended Platforms:** +- Printables (primary community hub) +- MakerWorld (growing ecosystem) +- Thingiverse (broader reach) + +**Best Practices:** +- Use "openGrid" tag for discoverability +- Include clear photos and descriptions +- Provide print settings and material recommendations +- Consider both lite and full board compatibility + +### Attribution Requirements +**CC-BY 4.0 License:** +- Attribution required for derivative works +- Commercial use permitted +- Modification and redistribution allowed +- Share-alike not required (unlike CC-BY-SA) + +## Community Support + +### Getting Help +**Documentation:** +- [FAQ section](./faq/) for common questions +- [Troubleshooting guide](./troubleshooting/) for problem solving +- [Video resources](./videos/) for visual learning + +**Community Forums:** +- Printables comment sections +- MakerWorld discussion areas +- Social media groups and communities + +### Reporting Issues +**For Core System:** +- Use platform-specific comment systems +- Provide clear problem descriptions +- Include photos when helpful +- Suggest improvements when possible + +## Future Development + +### Planned Enhancements +The openGrid ecosystem continues to evolve based on community feedback and needs: + +- Expanded compatibility with additional systems +- New snap types for specialized applications +- Enhanced generator capabilities +- Additional mounting solutions + +### Community Requests +Popular community-requested features often become official additions: + +- Specialized accessories for specific use cases +- Integration with emerging systems +- Performance optimizations +- Aesthetic variations + +## Success Stories + +The openGrid community has created solutions for: +- Workshop organization and tool storage +- Under-desk cable management systems +- Living room entertainment center organization +- Maker space modular storage +- Custom industrial applications + +Join the growing openGrid community and help shape the future of modular mounting systems! diff --git a/src/content/docs/compatibility.mdx b/src/content/docs/compatibility.mdx new file mode 100644 index 0000000..4478d19 --- /dev/null +++ b/src/content/docs/compatibility.mdx @@ -0,0 +1,103 @@ +--- +title: System Compatibility +description: How to use existing board systems and accessories with openGrid. +--- + +openGrid is designed to work with existing mounting systems and accessories, allowing you to leverage your current investments while gaining the benefits of the openGrid ecosystem. + +## Multiboard Integration + +### Full Compatibility +openGrid's larger 28mm grid provides enough space to accommodate full multiboard tiles: + +- **Full multiboard tiles**: Snap directly into openGrid holes +- **Multiconnect accessories**: Work without modification +- **Screw sizes**: All standard multiboard screws (small, mid, full) fit +- **Push-fit connectors**: Direct compatibility + +### Limitations +- **Multi-tile accessories**: 28mm spacing vs multiboard's spacing may cause alignment issues +- **Single-tile applications**: Work perfectly without modification + +## HSW (Honeycomb Storage Wall) + +HSW accessories can be adapted to openGrid: + +- **Thickness difference**: HSW is thicker than openGrid, causing slight protrusion +- **Functionality**: Full functionality maintained despite thickness mismatch +- **Use case**: Suitable for workshop environments where aesthetics are less critical + +## GOEWS Integration + +GOEWS uses Gridfinity grid sizing, making it compatible through the mathematical relationship: + +- **Grid relationship**: 2 Gridfinity units = 3 openGrid units = 84mm +- **Directional snaps**: Use GOEWS-specific directional snaps for proper attachment +- **Strength**: Maintains GOEWS system strength benefits +- **Installation**: Push snap in tilted, then it locks in place + +## Gridfinity Compatibility + +### Mathematical Compatibility +The grid systems align mathematically: +- **2 Gridfinity units**: 84mm (2 × 42mm) +- **3 openGrid units**: 84mm (3 × 28mm) + +### Practical Use +- **Most accessories**: Work with minimal or no modification +- **Border clearance**: Some accessories may need slight modification for proper fit +- **Shelving**: Gridfinity shelves integrate well with openGrid boards + +## Metric Screw Integration + +### M3 Hex Nut System +Standard metric hardware can be used with specialized snaps: + +- **M3 hex nut snaps**: Accept standard M3 hex nuts on the back +- **Load capacity**: Tested with 3-4kg loads successfully +- **Applications**: Heavy accessories, speakers, monitors +- **Installation**: Insert hex nut from back, screw from front + +### Benefits +- **Universal compatibility**: Works with any M3-threaded accessory +- **Strength**: Distributes load through metal hardware +- **Flexibility**: Accommodates non-3D printed accessories + +## Underware 2.0 Integration + +### Grid Size Modification +- **Change grid size**: Set to 28mm in Underware generators +- **Full compatibility**: All Underware features work unchanged +- **Space efficiency**: Eliminates base channel material waste + +### Channel Types +All standard Underware channels work: +- Straight and curved channels +- L-channels and T-junctions +- Custom generated sizes + +## Implementation Tips + +### Single vs Multi-Tile Accessories +- **Single-tile**: Usually work without modification +- **Multi-tile**: May require spacing adjustments or custom adapters + +### Adapter Strategy +- **Multiconnect snaps**: Universal solution for most systems +- **System-specific snaps**: Available for major systems (GOEWS, metric screws) +- **Custom adapters**: Design your own for unique requirements + +### Load Considerations +- **Light accessories**: Any snap type works +- **Heavy accessories**: Use directional or lock snaps +- **Very heavy items**: Consider metric screw integration + +## Community Resources + +The openGrid community continues to develop adapters and compatibility solutions: + +- **Printables**: Search "openGrid compatibility" or "openGrid adapter" +- **MakerWorld**: Growing collection of system adapters +- **Multiconnect ecosystem**: Extensive accessory library + +This compatibility approach allows you to transition gradually to openGrid while maintaining use of existing accessories and investments. diff --git a/src/content/docs/faq.mdx b/src/content/docs/faq.mdx new file mode 100644 index 0000000..833f4ba --- /dev/null +++ b/src/content/docs/faq.mdx @@ -0,0 +1,67 @@ +--- +title: Frequently Asked Questions +description: Common questions about openGrid answered. +--- + +## Why create openGrid when other board systems exist? + +The development of openGrid was motivated by three main issues with existing systems: + +1. **Material efficiency**: Traditional Underware setups require significant material and print time for base channels that don't directly contribute to cable management +2. **Living room compatibility**: Existing solutions often look industrial - openGrid was designed to be attractive enough for any room in the house +3. **Gridfinity compatibility**: While multiconnect exists for other boards, the dimensional mismatch made Gridfinity accessories look awkward on traditional grid systems + +openGrid addresses these by allowing direct snap-on accessories, clean aesthetics, and proper mathematical compatibility with Gridfinity (2 Gridfinity units = 3 openGrid units = 84mm). + +## What's the license for openGrid? + +openGrid is released under **Creative Commons Attribution 4.0 (CC-BY)**, which allows both commercial and non-commercial use. The license was changed from the initial non-commercial version to encourage broader adoption and ecosystem development. + +You only need to provide attribution when using or modifying openGrid designs. + +## How do I attach accessories to openGrid? + +openGrid uses a snap system with several options: + +- **Direct accessories**: Many accessories snap directly into the 28mm grid holes +- **Multiconnect compatibility**: Use multiconnect snaps to access a large ecosystem of existing accessories +- **Gridfinity compatibility**: The mathematical relationship allows most Gridfinity accessories to work with openGrid +- **Community accessories**: Growing collection of openGrid-specific designs on Printables and MakerWorld + +## How do I remove snaps and tiles? + +While snaps can be removed by hand, using a flat-head screwdriver makes it much easier: + +1. Insert the screwdriver on the side of the snap +2. Gently push outward to pop the snap out +3. For tiles with accessible edges, you can also push from underneath + +## Which board version should I use? + +**Full Board (6.8mm thick)**: +- Heavy-duty applications +- Maximum load capacity +- Requires mounting snaps for wall attachment + +**Lite Board (4mm thick)**: +- Light applications and space-constrained areas +- Built-in screw holes for direct mounting +- Uses approximately 70% less material than comparable systems + +## Can I use existing accessories from other systems? + +Yes! openGrid is designed for compatibility: + +- **Multiboard, HSW, GOEWS**: Use multiconnect snaps as adapters +- **Gridfinity**: Direct compatibility due to mathematical grid relationship +- **Metric screws**: Standard mounting options available +- **Underware**: Full compatibility with modified grid size (28mm) + +## How do I connect multiple boards? + +1. Insert connector pegs into all holes along the edge you want to connect +2. Align the second board with the first +3. Apply moderate pressure to snap boards together +4. The connection provides alignment and light structural support + +The grip is firm but not overly tight, allowing for easy reconfiguration when needed. diff --git a/src/content/docs/guides/accessories.mdx b/src/content/docs/guides/accessories.mdx index 8baab7e..2f919d8 100644 --- a/src/content/docs/guides/accessories.mdx +++ b/src/content/docs/guides/accessories.mdx @@ -1,16 +1,60 @@ --- title: Accessories -description: Overview of different accessories. +description: Overview of different accessories and how to use them with openGrid. --- -WIP, please come back later. +openGrid accessories attach to your board using the snap system, providing endless possibilities for organization and storage. The ecosystem includes both official accessories and a growing community of third-party designs. -You may for example search for openGrid related accessories for now: +## Core Accessories + +### Mounting Hardware +- **Mounting snaps**: For attaching full boards to walls +- **Cover tiles**: Create flat surfaces over mounting points +- **Connectors**: Align and connect multiple boards + +### Snap Types +- **Basic snaps**: Standard connection points for most accessories +- **Directional snaps**: Stronger hold with arrow marking for upward orientation +- **Lock snaps**: Print-in-place rotating mechanism for permanent attachment + +## Compatible Systems + +### Gridfinity Integration +openGrid's 28mm grid is mathematically compatible with Gridfinity's 42mm system: +- 2 Gridfinity units = 84mm +- 3 openGrid units = 84mm + +This allows most Gridfinity accessories to work with openGrid boards. + +### Multiconnect Support +Full compatibility with Multiconnect accessories, expanding your options significantly. Multiconnect snaps allow you to use accessories from multiple ecosystems. + +### Underware Integration +Specialized cable management system that mounts directly to openGrid boards, providing clean under-desk cable routing with minimal space requirements. + +## Community Accessories + +The openGrid ecosystem continues to grow with community contributions: + +**Holders & Storage:** * [openGrid holders on printables](https://www.printables.com/search/models?q=tag:opengrid+holder) * [openGrid holders on makerworld](https://makerworld.com/en/search/models?keyword=opengrid+holder) + +**Shelving Solutions:** * [openGrid shelves on printables](https://www.printables.com/search/models?q=tag:opengrid+shelve) * [openGrid shelves on makerworld](https://makerworld.com/en/search/models?keyword=opengrid+shelve) + +**Hooks & Hangers:** * [openGrid hooks on printables](https://www.printables.com/search/models?q=tag:opengrid+hook) * [openGrid hooks on makerworld](https://makerworld.com/en/search/models?keyword=opengrid+hook) + +**Multiconnect Accessories:** * [openGrid multiconnect accessories on printables](https://www.printables.com/search/models?q=tag:opengrid+multiconnect) * [openGrid multiconnect accessories on makerworld](https://makerworld.com/en/search/models?keyword=opengrid+multiconnect) + +## Installation Tips + +1. **Color coordination**: Use matching colors for boards and accessories for a clean look +2. **Snap selection**: Choose appropriate snap type based on load and removal frequency +3. **Board compatibility**: Ensure accessories match your board type (full vs lite) +4. **Planning**: Layout accessories before final installation for optimal organization diff --git a/src/content/docs/guides/board.mdx b/src/content/docs/guides/board.mdx index c8af6d1..62b3ef5 100644 --- a/src/content/docs/guides/board.mdx +++ b/src/content/docs/guides/board.mdx @@ -106,17 +106,103 @@ Full boards use separate mounting tiles that insert into the grid: All mounting operations can be performed from the front, allowing you to add additional mounting points after installation if needed. -## Design Philosophy - -OpenGrid follows several key design principles: - -**Living Room Compatible**: Clean aesthetics suitable for any room in the house, not just workshops or garages. - -**Front-Side Access**: All operations (mounting, connecting, accessory attachment) can be done from the front without wall access. - -**Material Efficiency**: Two board thicknesses optimize material usage and print time for different applications. - -**Open Framework**: Designed as a platform for community development rather than a closed ecosystem. +### Alternative Mounting Solutions + +**Community Mounting Options:** +- [openGrid mounts on printables](https://www.printables.com/search/models?q=tag:opengrid+mount) +- [openGrid mounts on makerworld](https://makerworld.com/en/search/models?keyword=opengrid+mount) + +**Metric Screw Integration:** +- M3 hex nut snaps for heavy-duty mounting +- Tested with 3-4kg loads successfully +- Compatible with any M3-threaded hardware +- Insert hex nut from back, screw from front + +**Specialized Applications:** +- Speaker mounting (demonstrated with Sonos Roam) +- Monitor arms and heavy accessories +- Industrial equipment mounting +- Custom hardware integration + +## Performance Comparison: Full vs Lite Boards + +### Specifications + +| Feature | Full Board | Lite Board | +|---------|------------|------------| +| **Thickness** | 6.8mm | 4mm | +| **Material Usage** | Standard | -70% vs comparable systems | +| **Load Capacity** | Heavy-duty | Light applications | +| **Mounting Method** | Mounting snaps required | Built-in screw holes | +| **Flexibility** | Rigid | Flexible but stable | +| **Print Time** | Longer | Significantly reduced | + +### Use Case Recommendations + +**Choose Full Board When:** +- Heavy accessories (tools, equipment, storage) +- Maximum load capacity needed +- Professional workshop environments +- Long-term permanent installations +- Multiple large accessories per board + +**Choose Lite Board When:** +- Light accessories (cables, small tools, organizers) +- Space constraints (under-desk applications) +- Quick installations needed +- Material/time efficiency is priority +- Underware cable management systems + +### Performance Characteristics + +**Full Board Advantages:** +- Maximum structural integrity +- Handles substantial weight loads +- Professional-grade durability +- Suitable for industrial applications +- Better for multi-accessory setups + +**Lite Board Advantages:** +- 70% material savings vs comparable systems +- Faster printing and installation +- Built-in mounting eliminates extra parts +- Ideal for confined spaces +- Maintains rigidity despite flexibility + +### Load Testing Results + +**Full Board:** +- Tested with heavy workshop tools +- Supports multiple large accessories simultaneously +- No flexing under normal loads +- Suitable for permanent installations + +**Lite Board:** +- Tested with 3-4kg loads successfully (using M3 hardware) +- Maintains stability for light-medium applications +- Some flexibility under load but remains functional +- Perfect for cable management and light storage + +### Material Efficiency + +Both board types offer significant material savings compared to traditional systems: +- **Lite Board**: 70% less material than comparable solutions +- **Full Board**: 30% less material than comparable solutions +- Reduced print time translates to lower energy costs +- Less material waste supports sustainable making + +### Selection Guidelines + +**For New Users:** +- Start with lite board for most applications +- Upgrade to full board only when load requirements demand it +- Test both types if uncertain about requirements + +**For Specific Applications:** +- **Underware systems**: Always use lite board for space efficiency +- **Tool walls**: Full board recommended for heavy tools +- **Living spaces**: Either works, choose based on load needs +- **Workshops**: Full board for primary storage, lite for accessories ## Gridfinity Compatibility diff --git a/src/content/docs/guides/index.mdx b/src/content/docs/guides/index.mdx index 494d3af..2942c1e 100644 --- a/src/content/docs/guides/index.mdx +++ b/src/content/docs/guides/index.mdx @@ -7,11 +7,19 @@ description: open-source, grid-based mounting system created by DavidD openGrid provides an opinionated, yet flexible, grid-based system for mounting things to surfaces. The goals for this system are: -* attain Living Room Compatibility, where the system integrates well within a variety of settings, not just a garage wall -* provide a robust set of core parts, so that less time is spent deciding on one part over another, and more time is spent actually mounting things -* use less filament than comparable frameworks (-70% for lite board, -30% for full board - compared to similar solutions) -* incorporate and interopt with other existing frameworks easily (e.g. Gridfinity, Multiconnect, and Underware) -* be open and allow people to extend things (core files are relased using the [CC-BY open license](http://creativecommons.org/licenses/by/4.0/)) +* **Living Room Compatibility**: The system integrates well within a variety of settings, not just a garage wall. openGrid was specifically designed to be attractive enough for any room in the house, moving beyond the industrial aesthetic of traditional workshop solutions. + +* **Robust Core Parts**: Provide a focused set of essential components, so less time is spent deciding between options and more time is spent actually mounting and organizing things. + +* **Material Efficiency**: Use significantly less filament than comparable frameworks (-70% for lite board, -30% for full board compared to similar solutions). This reduces both print time and material costs while maintaining functionality. + +* **Universal Compatibility**: Incorporate and interoperate with other existing frameworks easily (e.g. Gridfinity, Multiconnect, and Underware). Rather than creating another isolated ecosystem, openGrid serves as a bridge between systems. + +* **Open Development**: Be open and allow people to extend things (core files are released using the [CC-BY open license](http://creativecommons.org/licenses/by/4.0/)). The system is designed as a platform for community development rather than a closed product. + +* **Front-Side Access**: All operations (mounting, connecting, accessory attachment) can be performed from the front without requiring access to the back of the board once mounted. + +* **Space Optimization**: Eliminate wasted space in mounting systems. For example, traditional Underware setups waste approximately 1cm of vertical space that openGrid recovers for actual cable routing. Some common use cases for openGrid are: - Tool wall organization diff --git a/src/content/docs/guides/snaps.mdx b/src/content/docs/guides/snaps.mdx index de235cb..1bdbefc 100644 --- a/src/content/docs/guides/snaps.mdx +++ b/src/content/docs/guides/snaps.mdx @@ -157,3 +157,13 @@ Download the GOEWS snaps: **Note:** There are other snaps available through community models: * [openGrid mounts on printables](https://www.printables.com/search/models?q=tag:opengrid+snap) * [openGrid mounts on makerworld](https://makerworld.com/en/search/models?keyword=opengrid+snap) + +## Snap Removal + +While snaps can be removed by hand, using a screwdriver makes the process much easier: + +1. **For cover tiles and basic snaps**: Insert a flat-head screwdriver on the side of the snap +2. **Push outward**: Gently push the screwdriver to pop the snap out +3. **Alternative method**: For tiles with accessible edges, you can push from underneath + +**Note**: Cover tiles are designed to create flat surfaces, so finger removal is possible but more difficult than with other snap types. diff --git a/src/content/docs/maintenance.mdx b/src/content/docs/maintenance.mdx new file mode 100644 index 0000000..bc68516 --- /dev/null +++ b/src/content/docs/maintenance.mdx @@ -0,0 +1,120 @@ +--- +title: Maintenance & Care +description: How to maintain and care for your openGrid system. +--- + +openGrid is designed for long-term use with minimal maintenance. Following these guidelines will help ensure your system remains functional and attractive over time. + +## Regular Maintenance + +### Cleaning +- **Dust removal**: Use compressed air or soft brush to remove dust from grid holes +- **Surface cleaning**: Wipe boards with damp cloth using mild soap if needed +- **Avoid harsh chemicals**: Don't use solvents or abrasive cleaners that could damage plastic + +### Inspection +- **Check mounting points**: Periodically verify wall anchors and screws remain secure +- **Snap condition**: Look for cracks or wear in frequently used snaps +- **Board alignment**: Ensure connected boards remain properly aligned + +## Snap Maintenance + +### Removal and Replacement +- **Use proper technique**: Insert screwdriver on side and push outward gently +- **Avoid force**: Excessive force can crack snaps or damage board holes +- **Replace worn snaps**: Print new snaps when old ones become loose or damaged + +### Snap Selection +- **Match application**: Use appropriate snap type for load requirements +- **Rotate usage**: Move heavy accessories occasionally to distribute wear +- **Keep spares**: Print extra snaps for quick replacement when needed + +## Board Care + +### Full Boards +- **Mounting snap inspection**: Check that mounting snaps remain secure in wall +- **Load distribution**: Avoid concentrating heavy loads in single areas +- **Connection maintenance**: Verify connector pegs remain properly seated + +### Lite Boards +- **Screw tightness**: Periodically check that mounting screws haven't loosened +- **Flex monitoring**: Watch for excessive flexing that might indicate overloading +- **Crack inspection**: Look for stress cracks around screw holes + +## Accessory Maintenance + +### Gridfinity Integration +- **Fit checking**: Verify Gridfinity accessories still align properly +- **Border clearance**: Check that accessories don't bind against board edges +- **Weight limits**: Respect load limits for both openGrid and Gridfinity components + +### Underware Systems +- **Channel alignment**: Ensure channels remain properly snapped in place +- **Cable management**: Reorganize cables periodically to prevent wear +- **Open channels**: Keep ventilation channels clear of debris + +## Troubleshooting Wear Issues + +### Loose Snaps +**Symptoms**: Accessories fall off or feel unstable +**Solutions**: +- Replace worn snaps with fresh prints +- Switch to directional or lock snaps for better retention +- Check that snap is fully inserted into grid hole + +### Board Sagging +**Symptoms**: Board flexes or sags under load +**Solutions**: +- Add additional mounting points +- Redistribute weight across more grid positions +- Consider upgrading from lite to full board for heavy applications + +### Connection Problems +**Symptoms**: Boards separate or misalign +**Solutions**: +- Replace worn connector pegs +- Ensure all connection holes have pegs installed +- Check that boards are properly aligned during connection + +## Upgrade and Modification + +### System Expansion +- **Plan ahead**: Consider future needs when adding new sections +- **Color matching**: Use consistent colors for professional appearance +- **Load planning**: Distribute heavy accessories across multiple boards + +### Component Replacement +- **Modular design**: Individual components can be replaced without system rebuild +- **Print settings**: Use same settings as original parts for consistency +- **Material matching**: Use same filament type and brand when possible + +## Long-term Care + +### Environmental Considerations +- **Temperature**: Avoid extreme temperature changes that could cause warping +- **UV exposure**: Minimize direct sunlight exposure to prevent color fading +- **Humidity**: Normal indoor humidity levels are fine for PLA and PETG + +### Preventive Measures +- **Regular inspection**: Monthly visual checks prevent small issues from becoming big problems +- **Documentation**: Keep notes on which accessories go where for easy reconfiguration +- **Spare parts**: Maintain inventory of common snaps and connectors + +## When to Replace Components + +### Snaps +- Visible cracks or deformation +- Loose fit that doesn't improve with proper insertion +- Difficulty removing or installing + +### Boards +- Significant warping or permanent deformation +- Cracks around mounting points or grid holes +- Excessive wear that affects functionality + +### Connectors +- Loose fit between boards +- Visible wear or damage +- Difficulty inserting or removing + +With proper care, openGrid systems can provide years of reliable service while maintaining their clean, professional appearance. diff --git a/src/content/docs/projects/gridfinity.mdx b/src/content/docs/projects/gridfinity.mdx index 82d2f5c..8281e94 100644 --- a/src/content/docs/projects/gridfinity.mdx +++ b/src/content/docs/projects/gridfinity.mdx @@ -1,11 +1,128 @@ --- -title: Gridfinity -description: Gridfinity is supported by openGrid. +title: Gridfinity Integration +description: How openGrid works with the Gridfinity ecosystem. --- -WIP, please come back later. +## Overview -For now, just click one of those links: -* [Gridfinity shelves on printables](https://www.printables.com/model/1214460-opengrid-gridfinity-shelves) -* [Gridfinity shelves on makerworld](https://makerworld.com/en/models/1169053-opengrid-gridfinity-shelves) -* [Infinity shelves on makerworld](https://makerworld.com/en/models/1469935-infinite-gridfinity-shelf-for-opengrid-very-strong) +Gridfinity is a popular modular storage system created by Zack Freedman that uses a 42mm grid pattern. openGrid provides excellent compatibility with Gridfinity through mathematical grid relationships and dedicated shelving solutions. + +## Grid Compatibility + +The mathematical relationship between openGrid and Gridfinity grids enables seamless integration: + +- **2 Gridfinity units** = 84mm (2 × 42mm) +- **3 openGrid units** = 84mm (3 × 28mm) + +This 2:3 ratio means that Gridfinity accessories designed for 2×2, 4×2, or other even dimensions will align perfectly with openGrid's 3×3, 6×3, etc. grid positions. + +## Integration Methods + +### Direct Compatibility +Many Gridfinity accessories work directly with openGrid boards: +- Storage bins and containers +- Tool holders and organizers +- Custom accessories from the community +- Most accessories require no modification + +### Gridfinity Shelves +Dedicated shelving systems provide the best integration: + +**openGrid Gridfinity Shelves:** +- [Gridfinity shelves on printables](https://www.printables.com/model/1214460-opengrid-gridfinity-shelves) +- [Gridfinity shelves on makerworld](https://makerworld.com/en/models/1169053-opengrid-gridfinity-shelves) + +**Enhanced Shelf Options:** +- [Infinite Gridfinity shelf on makerworld](https://makerworld.com/en/models/1469935-infinite-gridfinity-shelf-for-opengrid-very-strong) +- Stronger construction for heavy loads +- Extended length options + +### Multiconnect Integration +Use Multiconnect snaps to access the broader Gridfinity ecosystem: +- Multiconnect Gridfinity adapters +- Universal compatibility solution +- Works with existing Gridfinity accessories + +## Use Cases + +### Workshop Organization +- Tool storage in Gridfinity bins +- Small parts organization +- Modular storage that grows with needs +- Easy reconfiguration for different projects + +### Desk Organization +- Office supplies in Gridfinity containers +- Electronics component storage +- Craft supply organization +- Clean, professional appearance + +### Maker Spaces +- Shared tool organization +- Standardized storage across different areas +- Easy identification and access +- Scalable storage solutions + +## Design Considerations + +### Border Clearance +Some Gridfinity accessories may need slight modifications: +- Check border dimensions for proper fit +- File or sand edges if binding occurs +- Most accessories work without modification + +### Load Distribution +- Distribute heavy Gridfinity bins across multiple grid points +- Use appropriate snap types for load requirements +- Consider board type (full vs lite) for heavy applications + +### Aesthetic Integration +- Choose colors that complement your openGrid setup +- Consider transparent or matching filament colors +- Maintain the clean, professional appearance + +## Community Resources + +### Existing Accessories +The Gridfinity ecosystem includes thousands of community-designed accessories: +- Storage solutions for specific tools +- Custom organizers for hobbies +- Professional workshop storage +- Specialized containers and holders + +### Adaptation Guidelines +When adapting Gridfinity designs for openGrid: +- Verify grid alignment using the 2:3 ratio +- Test fit before printing large quantities +- Share successful adaptations with the community +- Document any modifications needed + +## Installation Tips + +### Shelf Mounting +1. **Choose appropriate snaps**: Use directional or lock snaps for heavy loads +2. **Plan layout**: Consider accessibility and weight distribution +3. **Test fit**: Verify Gridfinity accessories fit properly before final installation +4. **Secure mounting**: Ensure shelves are properly supported + +### Accessory Selection +- **Light items**: Any snap type works +- **Heavy storage**: Use directional or lock snaps +- **Frequently accessed**: Consider ease of removal +- **Permanent storage**: Lock snaps provide maximum security + +## Advantages of openGrid + Gridfinity + +### Combined Benefits +- **Living room compatibility**: openGrid's clean aesthetics with Gridfinity's functionality +- **Material efficiency**: openGrid's reduced material usage with Gridfinity's proven designs +- **Ecosystem access**: Tap into the vast Gridfinity community +- **Flexibility**: Easy reconfiguration as needs change + +### Unique Features +- **Front-side access**: All operations from the front, unlike traditional Gridfinity setups +- **Wall mounting**: Vertical storage saves desk/bench space +- **Modular expansion**: Add boards and accessories as needed +- **System integration**: Works with other openGrid-compatible systems + +The combination of openGrid and Gridfinity provides a powerful, flexible storage solution that maintains professional aesthetics while offering the functionality of the proven Gridfinity ecosystem. diff --git a/src/content/docs/projects/multiconnect.mdx b/src/content/docs/projects/multiconnect.mdx index b43f978..77041c0 100644 --- a/src/content/docs/projects/multiconnect.mdx +++ b/src/content/docs/projects/multiconnect.mdx @@ -5,12 +5,19 @@ description: Multiconnect is the default interface for attaching things. import { Image } from 'astro:assets'; import multiconnectSnapsImage from '../../../assets/multiconnect-snaps.png'; +## Overview + Multiconnect is openGrid's universal connection system that allows you to attach accessories and integrate with existing modular wall systems. It serves as a bridge between different organizational systems, letting you reuse accessories across multiple platforms while maintaining compatibility with your current setup. All Multiconnect snaps feature a threaded hole in the center to allow for secure mounting and easy removal. The snap system is designed to work seamlessly across different modular wall systems while maintaining the strength and reliability needed for everyday use. Different snap variants for multiconnect. -Download the multiconnect snaps: +## Getting Started + +For step-by-step setup instructions, see the [Multiconnect Quickstart Guide](../../guides/quickstart/multiconnect/). + +## Downloads + * [openGrid on printables](https://www.printables.com/model/1214361-opengrid-walldesk-mounting-framework-and-ecosystem) * [openGrid on makerworld](https://makerworld.com/en/models/1179191-opengrid-wall-desk-mounting-framework-ecosystem) diff --git a/src/content/docs/projects/underware.mdx b/src/content/docs/projects/underware.mdx index 5658bbd..dc3b45b 100644 --- a/src/content/docs/projects/underware.mdx +++ b/src/content/docs/projects/underware.mdx @@ -1,11 +1,63 @@ --- -title: Example Reference -description: A reference page in my new Starlight docs site. +title: Underware Integration +description: Cable management system optimized for openGrid boards. --- -WIP, please come back later. +## Overview + +Underware for openGrid is a cable management system that provides clean, efficient under-desk cable routing. The openGrid version addresses space efficiency issues found in traditional Underware setups while maintaining full compatibility with the Underware ecosystem. + +## Space Efficiency Benefits + +Traditional Underware systems require: +- 6.4mm thick multiboard base +- Additional channel base thickness +- **Total: ~1cm of wasted space** before cables have room + +openGrid Underware eliminates this waste by: +- Snapping channels directly to the board +- Using the board itself as the mounting surface +- **Saving approximately 1cm of vertical space** + +This makes openGrid Underware ideal for tight spaces under desks where every millimeter counts. + +## Channel Types + +### Basic Channels +- **Straight channels**: Standard cable routing, works with all cable types +- **Curved channels**: Rounded profile for softer cables, more aesthetic appeal +- **L-channels**: Corner routing and direction changes + +### Specialized Channels +- **T-channels**: Junction points for multiple cable runs +- **Row-change channels**: Move cables between different levels +- **Various sizes**: Different widths to accommodate cable bundles + +## Installation + +1. **Mount openGrid Lite board** under your desk using built-in screw holes +2. **Snap Underware channels** directly into board grid holes +3. **Route cables** through the channel system +4. **Add/remove channels** as needed - all accessible from the front + +## Cable Compatibility + +**Soft cables**: Work well with both straight and curved channels +**Rigid cables**: Use straight channels for easier installation and better fit + +## Generator Support + +Full compatibility with Andy's (Blackjack Duck) Underware generator: +- Change grid size to 28mm for openGrid compatibility +- All other settings work as normal +- Generates channels optimized for your specific setup + +## Getting Started + +For step-by-step setup instructions, see the [Underware Quickstart Guide](../../guides/quickstart/underware/). + +## Downloads -For now, just click one of those links: * [openGrid Underware on printables](https://www.printables.com/model/1214427-underware-for-opengrid-manage-your-cables-lite-ly) * [openGrid Underware on makerworld](https://makerworld.com/en/models/1175037-underware-for-opengrid) * [openGrid Underware generator on makerworld](https://makerworld.com/en/models/1329404-underware-for-opengrid-customizer-beta) diff --git a/src/content/docs/troubleshooting.mdx b/src/content/docs/troubleshooting.mdx new file mode 100644 index 0000000..69b187f --- /dev/null +++ b/src/content/docs/troubleshooting.mdx @@ -0,0 +1,106 @@ +--- +title: Troubleshooting +description: Common issues and solutions for openGrid. +--- + +## Board Connection Issues + +### Connectors Too Tight +**Problem**: Difficulty connecting boards with connector pegs +**Solutions**: +- Check print tolerances and calibration +- Light sanding of connector pegs if needed +- Print at 99.5% scale if your printer runs large +- Ensure proper layer adhesion during printing + +### Board Flexing +**Problem**: Board bends or flexes under load +**Solutions**: +- Add more mounting points +- Switch from lite board to full board for heavy applications +- Ensure proper wall anchoring +- Distribute weight across multiple grid points + +## Snap and Accessory Issues + +### Snaps Not Holding +**Problem**: Accessories fall off or don't stay secure +**Solutions**: +- Verify correct snap type for your application +- Use directional snaps for better holding power +- Consider lock snaps for permanent installations +- Check that snap is fully inserted into grid hole + +### Difficult Snap Removal +**Problem**: Can't remove snaps or tiles easily +**Solutions**: +- Use flat-head screwdriver technique (insert on side, push outward) +- For cover tiles, access from edges where possible +- Apply gentle, steady pressure rather than force +- Ensure you're pushing from the flexible side of directional snaps + +## Cable Management Issues + +### Rigid Cables Won't Fit in Curved Channels +**Problem**: Stiff cables difficult to route through rounded Underware channels +**Solutions**: +- Use straight channel versions for rigid cables +- Pre-bend cables before installation +- Consider larger channel sizes for thick cable bundles +- Use open channel concept for cables that need to exit mid-run + +### Cables Keep Falling Out +**Problem**: Cables don't stay in Underware channels +**Solutions**: +- Use zip tie attachment points on special tiles +- Route cables through multiple attachment points +- Consider closed channel designs for loose cables +- Ensure proper channel sizing for your cable diameter + +## Print Quality Issues + +### Poor Surface Finish +**Problem**: Rough or inconsistent print quality +**Solutions**: +- Use 0.2mm layer height for optimal balance +- 15-20% infill is sufficient for most applications +- Ensure proper bed adhesion and temperature settings +- Check for proper cooling during bridging sections + +### Dimensional Accuracy Problems +**Problem**: Parts don't fit together properly +**Solutions**: +- Calibrate printer for dimensional accuracy +- Check belt tension and mechanical issues +- Verify correct filament diameter settings +- Consider printing test pieces to verify tolerances + +## Installation Issues + +### Wall Mounting Problems +**Problem**: Board doesn't sit flush or secure on wall +**Solutions**: +- Use appropriate wall anchors for your wall type +- Ensure mounting snaps are fully inserted before screwing +- Check wall flatness - shim if necessary +- For lite boards, use built-in screw holes for direct mounting + +### Accessories Don't Align +**Problem**: Gridfinity or other accessories don't line up properly +**Solutions**: +- Verify 28mm grid spacing is correct +- Check that accessories are designed for proper grid relationship +- Some accessories may need slight modification for border clearance +- Ensure board is properly square during installation + +## Material and Compatibility Issues + +### Incompatible Accessories +**Problem**: Existing accessories don't work with openGrid +**Solutions**: +- Use multiconnect snaps as universal adapters +- Check community remixes for openGrid versions +- Consider designing custom adapters +- Verify grid size compatibility (28mm for openGrid) + +If you continue to experience issues, check the community forums on Printables and MakerWorld, or refer to the [FAQ section](./faq) for additional guidance. diff --git a/src/content/docs/videos.mdx b/src/content/docs/videos.mdx new file mode 100644 index 0000000..260471b --- /dev/null +++ b/src/content/docs/videos.mdx @@ -0,0 +1,98 @@ +--- +title: Video Resources +description: Official openGrid video tutorials and demonstrations. +--- + +Learn about openGrid through these official video tutorials that cover everything from basic concepts to advanced integration techniques. + +## Introduction and Overview + +### openGrid Intro - 3D printed open board ecosystem +**[Watch on YouTube](https://www.youtube.com/watch?v=2mDBue4fw3U)** + +This foundational video introduces the openGrid system, demonstrating: +- Basic board concepts and construction +- Connection system using pegs +- Snap types (basic, directional, lock snaps) +- Board versions (full vs lite) +- Color coordination recommendations + +Perfect starting point for understanding what openGrid is and how it works. + +## Q&A Sessions + +### openGrid Q&A - Why? License? Accessories? Answers to all your questions! +**[Watch on YouTube](https://www.youtube.com/watch?v=uiAWPknA8Yo)** + +Addresses the most common questions about openGrid: +- Why create another board system? +- Material efficiency motivations +- Living room compatibility goals +- License information (CC-BY 4.0) +- Accessory ecosystem and compatibility + +Essential viewing for understanding the design philosophy and project goals. + +### openGrid Q&A - About Snap Removal +**[Watch on YouTube](https://www.youtube.com/watch?v=XDdKp0uLUSU)** + +Focused tutorial on removing snaps and tiles: +- Screwdriver technique for easy removal +- Working with cover tiles +- Handling different snap types +- Practical demonstration of removal methods + +Helpful for maintenance and reconfiguration of your openGrid setup. + +## Specialized Applications + +### openGrid Underware - Getting your Underware setup faster and with less material +**[Watch on YouTube](https://www.youtube.com/watch?v=Ql24ZfvWYPk)** + +Deep dive into cable management integration: +- Space efficiency benefits (1cm savings) +- Channel types and selection +- Cable compatibility considerations +- Installation techniques +- Comparison with traditional Underware setups + +Must-watch for under-desk cable management applications. + +### openGrid Compatibility - How to use existing solutions like Multiboard, HSW, GOEWS and metric screws +**[Watch on YouTube](https://www.youtube.com/watch?v=tBS_ir6ru78)** + +Comprehensive compatibility demonstration: +- Multiboard integration techniques +- HSW and GOEWS system compatibility +- Metric screw mounting options +- Gridfinity mathematical relationships +- Practical examples of system integration + +Critical for users wanting to integrate existing accessories and systems. + +## Video Learning Path + +### For Beginners +1. **Start with the Introduction video** to understand basic concepts +2. **Watch the main Q&A video** for design philosophy and goals +3. **Review the snap removal video** for maintenance techniques + +### For Specific Applications +- **Cable Management**: Focus on the Underware integration video +- **System Integration**: Watch the compatibility video for existing accessories +- **Troubleshooting**: Combine snap removal techniques with compatibility guidance + +### For Advanced Users +- All videos provide insights into design decisions and advanced techniques +- Compatibility video shows integration strategies for complex setups +- Q&A sessions reveal optimization opportunities and best practices + +## Additional Resources + +While watching these videos, refer to the corresponding documentation sections: +- [Quickstart Guide](./guides/quickstart/) for hands-on setup +- [Compatibility Guide](./compatibility/) for detailed system integration +- [FAQ](./faq/) for quick answers to common questions +- [Troubleshooting](./troubleshooting/) for problem-solving guidance + +The video content provides visual demonstrations that complement the written documentation, making it easier to understand complex assembly and integration procedures.