Skip to content

jaffarkeikei/valisha

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Valisha - Custom Beaded Wristbands

Valisha (Swahili: "to wear") - Custom beaded wristbands, crafted with precision.

Status License Started

What is Valisha?

Valisha is a custom beaded wristband service. Customers choose their design (country flags, names, custom patterns), and I create beautiful beaded wristbands using an automated bead printer that I'm building.

This is an open-source project - I'm documenting the entire build process so others can learn from it or build their own.

Features

  • 195+ Country Flags - Accurate patterns with proper proportions
  • Custom Names - Your name spelled out in beads (A-Z supported)
  • Custom Designs - Any pattern you can imagine
  • Perfect Sizing - Measured to fit your wrist

Project Structure

valisha/
├── README.md              # This file
├── images/                # Sample product photos
├── docs/                  # Technical documentation
│   ├── HARDWARE_REQUIREMENTS.md  # Parts list for the printer
│   ├── SOFTWARE_ARCHITECTURE.md  # System design
│   ├── MECHANICAL_DESIGN.md      # Physical construction
│   ├── ELECTRICAL_DESIGN.md      # Circuits and wiring
│   ├── BEAD_PATTERN_SPEC.md      # How patterns work
│   └── USER_MANUAL.md            # Operating guide
├── firmware/              # ESP32 printer firmware
├── hardware/              # Schematics, PCB, 3D models
│   ├── schematics/
│   ├── pcb/
│   └── 3d-models/
└── webapp/                # Customer ordering website

Current Progress

  • Project documentation
  • Customer ordering website (React/TypeScript)
  • Pattern system (flags + text rendering)
  • Build prototype printer
  • Firmware development
  • Testing & calibration
  • Launch service

The Printer

I'm building an automated bead wristband printer from scratch. Key components:

Component Purpose
ESP32 Main controller
Stepper Motors Bead carousel, positioning
ToF Sensors Wrist measurement
12 Hoppers Color storage (500 beads each)

Estimated build cost: ~$500

Full parts list: docs/HARDWARE_REQUIREMENTS.md

Web Application

The customer-facing website lets users:

  1. Choose a flag or enter their name
  2. See a live bead pattern preview
  3. Enter wrist size
  4. Place an order

Tech stack: React, TypeScript, Tailwind CSS, Framer Motion

cd webapp
npm install
npm run dev

Documentation

Document Description
Hardware Requirements Complete parts list
Software Architecture System design
Mechanical Design Frame & mechanisms
Electrical Design Circuits & wiring
Bead Pattern Spec How patterns are structured

Contributing

This is a personal project I'm building in public. Feel free to:

  • Open issues with questions or suggestions
  • Submit PRs for improvements
  • Fork and build your own version

License

MIT License - See LICENSE for details.


Valisha - Wear Your Story

About

Valisha (Swahili: "to wear") - An open-source automated bead wristband printer system. Create custom beaded wristbands featuring country flags, names, or custom patterns. This project includes: - ESP32 firmware for the printer , hardware schematics & 3D models

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors