131 lines
4.4 KiB
Markdown
131 lines
4.4 KiB
Markdown
# OSSM Configurator
|
|
|
|
A web-based configuration tool for the Open Source Sex Machine (OSSM) project. This application provides an intuitive wizard interface that guides users through selecting and customizing components for their OSSM build, generating a complete Bill of Materials (BOM) and configuration summary.
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
OSSM-Configurator/
|
|
├── website/ # Main web application
|
|
│ ├── src/ # React source code
|
|
│ ├── public/ # Static assets (images, etc.)
|
|
│ ├── dist/ # Build output (generated)
|
|
│ ├── node_modules/ # Dependencies (generated)
|
|
│ └── ... # Configuration files
|
|
├── BOM.xlsx # Bill of Materials spreadsheet
|
|
├── Screen Shots/ # Application screenshots
|
|
└── README.md # This file
|
|
```
|
|
|
|
## Website Overview
|
|
|
|
The OSSM Configurator is a React-based single-page application built with Vite. It provides a step-by-step wizard interface that allows users to:
|
|
|
|
1. **Select Motor** - Choose from available motor options (42AIM30, 57AIM30, iHSV57)
|
|
2. **Choose Power Supply** - Select appropriate power supply (24V PSU, 24V USB-C PD)
|
|
3. **Customize Colors** - Pick primary and accent colors for 3D printed parts
|
|
4. **Configure Options** - Select mounting options, stands, toy mounts, actuators, and other components
|
|
5. **Review Summary** - View complete BOM with pricing, filament estimates, and export options
|
|
|
|
### Key Features
|
|
|
|
- **Interactive Wizard Interface**: Step-by-step configuration process with progress tracking
|
|
- **Component Compatibility**: Ensures selected components are compatible with each other
|
|
- **Real-time Pricing**: Calculates total cost including hardware and printed parts
|
|
- **Filament Estimates**: Provides 3D printing filament requirements for each component
|
|
- **BOM Export**: Generate and download a complete Bill of Materials
|
|
- **Visual Component Selection**: Image-based component selection for better user experience
|
|
|
|
### Technology Stack
|
|
|
|
- **React 18** - UI framework
|
|
- **Vite** - Build tool and dev server
|
|
- **Tailwind CSS** - Styling
|
|
- **JSZip** - For generating downloadable BOM packages
|
|
|
|
## Getting Started
|
|
|
|
### Prerequisites
|
|
|
|
- Node.js (v16 or higher recommended)
|
|
- npm or yarn
|
|
|
|
### Installation
|
|
|
|
1. Navigate to the website directory:
|
|
```bash
|
|
cd website
|
|
```
|
|
|
|
2. Install dependencies:
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
### Development
|
|
|
|
Run the development server:
|
|
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
The application will be available at `http://localhost:5173` (or the port shown in the terminal).
|
|
|
|
### Building for Production
|
|
|
|
Create an optimized production build:
|
|
|
|
```bash
|
|
npm run build
|
|
```
|
|
|
|
The built files will be in the `website/dist/` directory.
|
|
|
|
### Preview Production Build
|
|
|
|
Preview the production build locally:
|
|
|
|
```bash
|
|
npm run preview
|
|
```
|
|
|
|
## Configuration Data
|
|
|
|
The application uses JSON data files located in `website/src/data/`:
|
|
|
|
- `motors.json` - Available motor options
|
|
- `powerSupplies.json` - Power supply options
|
|
- `colors.json` - Available color options
|
|
- `options.json` - Main configuration options
|
|
- `components/` - Detailed component data:
|
|
- `actuator.json` - Actuator components
|
|
- `mounting.json` - Mounting options
|
|
- `remote.json` - Remote control components
|
|
- `stand.json` - Stand components
|
|
- `toyMounts.json` - Toy mount options
|
|
|
|
## Project Purpose
|
|
|
|
The OSSM Configurator serves as a comprehensive tool for users building their own Open Source Sex Machine. It simplifies the configuration process by:
|
|
|
|
- **Guiding Selection**: Step-by-step wizard prevents missing critical components
|
|
- **Ensuring Compatibility**: Validates component combinations
|
|
- **Providing Transparency**: Shows costs, filament requirements, and time estimates
|
|
- **Generating Documentation**: Creates exportable BOM for ordering parts and printing
|
|
|
|
This tool is essential for both beginners and experienced builders who want to ensure they have all necessary components and understand the full scope of their build before starting.
|
|
|
|
## Contributing
|
|
|
|
When adding new components or options:
|
|
|
|
1. Update the appropriate JSON data files in `website/src/data/`
|
|
2. Add corresponding images to `website/public/images/`
|
|
3. Test the configuration flow to ensure compatibility
|
|
4. Update component pricing and filament estimates as needed
|
|
|
|
## License
|
|
|
|
This project is part of the Open Source Sex Machine (OSSM) project. Please refer to the OSSM project license for usage terms.
|