Aiuto & Documentazione
Tutto ciò che devi sapere sui prodotti cycleWASH, la piattaforma SPIRIT e la gestione del tuo account.
Prodotti
Mini, Pro, OASIS Station — specifiche, installazione, guide di manutenzione
SPIRIT App
Piattaforma IoT, monitoraggio in tempo reale, integrazione pagamenti, analisi
Dashboard Admin
CRM, generatore di contenuti, outreach, gestione campagne
iPhone App
Scaricare, configurare, trovare stazioni, gestire account, premi fedeltà
API & Code
API REST, GraphQL, protocollo MQTT, webhook, personalizzazione tema
Spedizione e Pagamenti
Consegna mondiale, metodi di pagamento, fatturazione, leasing
Product Documentation
| Spec | Mini Basic | Mini Platinum | Pro Basic | Pro Platinum | OASIS |
|---|---|---|---|---|---|
| Weight | ~45 kg | ~55 kg | ~85 kg | ~95 kg | ~450 kg |
| Wash Time | 45 sec | 45 sec | 60 sec | 60 sec | 90 sec |
| Water/Wash | 3 L | 3 L | 5 L | 5 L | 5 L |
| Power | Solar | Solar + Battery | Battery | Solar + Battery | Solar + Grid |
| IoT | — | SPIRIT Basic | — | SPIRIT Pro | SPIRIT Enterprise |
| Display | — | LCD | — | LCD Touch | Digital Kiosk |
| Payment | Coin/QR | Nayax + App | Coin/QR | Nayax + App | Full Terminal |
Installation Guide — Step by Step
Site Preparation
Ensure a flat, level surface (concrete or paving recommended). Mini requires 2m² space; Pro requires 3m²; OASIS requires 4×6m. Water drain access within 3m recommended.
Water Connection
Standard ½" garden hose connection. Water pressure: 2-6 bar. For OASIS stations, a permanent ¾" water supply line is recommended. All models include a quick-connect fitting.
Unboxing & Assembly
Mini: 2 people, 15 minutes. Pro: 2-3 people, 30 minutes. OASIS: Professional installation team (2-3 days). Remove all shipping brackets and protective film. Keep packaging for warranty claims.
Power Setup
Solar models: Position with panels facing south (northern hemisphere). Allow 24h initial battery charge before first use. Grid models: Connect to 230V/16A supply via included cable.
Fill Detergent
Use only cycleWASH certified biodegradable cleaning solution. Fill tank to MAX line. One fill lasts ~200 washes (Mini) or ~150 washes (Pro/OASIS). Never use household detergent.
SPIRIT IoT Activation (Platinum/OASIS)
Power on → LCD shows WiFi setup screen → Connect to cycleWASH hotspot → Enter your WiFi credentials → Dashboard activates within 5 minutes at spirit.cyclewash.com
Test Wash
Run 3 test cycles without a bicycle to flush the system. Check for leaks at all connections. Verify brush rotation, water flow, and detergent dispensing. First real wash: use a beater bike.
Maintenance Schedule
| Task | Frequency | Time | Tools |
|---|---|---|---|
| Refill cleaning solution | Every 150-200 washes | 5 min | None |
| Clean water filter | Monthly | 10 min | Wrench |
| Inspect brush condition | Monthly | 5 min | Visual |
| Replace brushes | Every 10,000 washes | 30 min | Allen key set |
| Check battery health | Quarterly | 5 min | SPIRIT dashboard |
| Clean solar panels | Monthly | 10 min | Soft cloth + water |
| Full service inspection | Annually | 2-4 hours | Service kit |
SPIRIT Platform Documentation
Operator Dashboard
Real-time monitoring, revenue tracking, fleet management at spirit.cyclewash.com
Technician Portal
Remote diagnostics, maintenance scheduling, firmware updates, alert management
Customer App
Find stations, start washes, payment, wash history, loyalty rewards
SPIRIT Dashboard — Getting Started
Create Your Account
Visit spirit.cyclewash.com → Click "Register" → Enter your company details and the machine serial number from the nameplate (format: CW-XXXX-XXXXXX).
Connect Your Machine
On your machine's LCD: Settings → WiFi → Enter credentials. The machine will appear in your dashboard within 5 minutes. Status LED turns solid blue when connected.
Configure Payment
Dashboard → Settings → Payments → Enable desired methods: Nayax (contactless cards), QR code (app), Coin acceptor. Set pricing per wash cycle (recommended: €2-5).
Set Up Alerts
Dashboard → Alerts → Configure: Low water, low detergent, maintenance due, offline alert, revenue milestone. Notifications via email, SMS, or push notification.
SPIRIT API Reference
https://api.spirit.cyclewash.com/v1Authentication: Bearer token (obtained via OAuth2 client credentials flow)
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /machines | List all machines in your fleet |
| GET | /machines/{id}/status | Real-time machine status (water, battery, last wash) |
| GET | /machines/{id}/analytics | Usage analytics (washes, revenue, water consumption) |
| POST | /machines/{id}/command | Send command (start_wash, stop, diagnostic) |
| GET | /revenue | Revenue report by date range |
| GET | /alerts | Active maintenance and system alerts |
| WS | /ws/machines/{id} | WebSocket for real-time telemetry stream |
Example: Get Machine Status
curl -X GET https://api.spirit.cyclewash.com/v1/machines/CW-2024-001234/status \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
# Response:
{
"machine_id": "CW-2024-001234",
"model": "Pro Platinum",
"status": "idle",
"battery_level": 87,
"water_level": 64,
"detergent_level": 45,
"total_washes": 12847,
"today_washes": 23,
"today_revenue": 92.00,
"last_wash": "2026-04-06T14:32:00Z",
"firmware": "3.2.1",
"connectivity": "wifi",
"solar_output_watts": 285,
"location": { "lat": 50.9503, "lng": 6.9588 }
}
MQTT Topics
# Subscribe to machine telemetry
cyclewash/{machine_id}/telemetry → { battery, water, solar, temp }
cyclewash/{machine_id}/status → { state: idle|washing|error }
cyclewash/{machine_id}/wash → { started_at, duration, water_used }
cyclewash/{machine_id}/alert → { type, severity, message }
# Publish commands
cyclewash/{machine_id}/command → { action: "start_wash" | "stop" | "diagnostic" }
cyclewash/{machine_id}/config → { price, wash_duration, eco_mode }
# MQTT Broker: mqtt.spirit.cyclewash.com:8883 (TLS)
# Protocol: MQTT v5.0 over WSS
Admin Dashboard Documentation
Default password: admin75 (change this in theme settings)
Dashboard Modules
Pipeline: 5-stage Kanban board (Lead → Contact → Demo → Proposal → Won). Drag cards between stages. Click a card to see full contact details, notes, and activity timeline.
Contacts: Synced with Shopify Customers. Add tags (hot-lead, demo-booked, partner) to segment. Filter by stage, tag, country, or product interest.
Campaigns: Uses Shopify Email for sending. Create campaigns from templates, select recipient segments, schedule delivery. Track opens, clicks, and conversions in Shopify Marketing dashboard.
Lead Finder: Apify-powered company enrichment. Enter industry + location → get company names, websites, contact info. Import directly to pipeline.
Analytics: Conversion rates by stage, response times, pipeline value, forecast. Data pulled from Shopify + localStorage.
SPIRIT Sync: View IoT machine data alongside CRM contacts. See which customers have active machines, usage patterns, and maintenance needs.
How to use:
- Select Content Type: Blog Post, LinkedIn, Instagram, Facebook, TikTok, Press Release, or Email Newsletter
- Select Topic: Sustainability, Technology, Product launch, Case study, Industry news, Bike care tips, Events, Company news
- Select Target Audience: Cities, Bike-sharing, Bike shops, Real estate, Cyclists, Investors
- Select Language: EN, DE, FR, ES, NL, IT
- Optionally add Custom Context (specific details, product features, key messages)
- Click Generate Content → Copy output → Paste into Shopify Blog / Social media platform
Pre-built templates: LinkedIn sustainability, LinkedIn technology, LinkedIn product launches, Instagram posts, TikTok scripts, Facebook posts — all with optimized hashtags.
Where to find reports: Shopify Admin → Analytics → Reports
Key reports:
- Sales: Total sales, average order value, sales by product
- Customers: New vs returning, customer lifetime value, geographic distribution
- Marketing: Channel attribution (Google, LinkedIn, Direct), campaign performance
- Behavior: Top pages, bounce rate, session duration
- Email: Open rate, click rate, unsubscribe rate per campaign
Current metrics: 335 emails sent, 97% delivery, 46% open rate via Shopify Email from sales@cyclewash.com
Theme Customization: Shopify Admin → Online Store → Themes → Customize. All 95+ sections are configurable with drag-and-drop.
Products: Admin → Products. Each product has variants (Basic/Platinum), pricing per market, and inventory tracking.
Markets: Admin → Settings → Markets. Three active markets: Germany (EUR), International (235 regions), United States (USD). Each market has separate pricing, language, and domain settings.
Shipping: Admin → Settings → Shipping. Configure zones: Germany (free >€10k), EU, US, Worldwide. Add carrier-calculated rates for accurate pricing.
Payments: Admin → Settings → Payments. Shopify Payments (primary), PayPal, Shop Pay, Apple/Google Pay. No Stripe needed.
cycleWASH iPhone App
App Setup — Step by Step
Download & Install
Open the App Store → Search "cycleWASH SPIRIT" → Tap "Get" → App installs automatically. Requires iOS 15.0 or later, iPhone 8 or newer.
Create Your Account
Open the app → Tap "Sign Up" → Enter email and create password (or sign in with Apple ID / Google). Verify your email with the 6-digit code sent to your inbox.
Add Payment Method
Profile → Payment Methods → Add: Apple Pay (recommended), credit/debit card, or PayPal. You can also purchase wash credits in bundles (10-pack, 20-pack) for discounts.
Enable Location Services
Allow location access to find nearby stations. The map shows all cycleWASH stations with real-time availability, wait times, and walking directions.
Your First Wash
Find a station on the map → Tap "Start Wash" → Scan the QR code on the machine (or tap NFC) → Place your bike → Wash starts automatically → Payment charged after completion.
App Features
| Feature | Description | Tier |
|---|---|---|
| 🗺️ Station Finder | Map with real-time availability, hours, pricing | Free |
| 📱 QR/NFC Start | Start a wash by scanning the station QR code | Free |
| 📊 Wash History | Complete log of all washes with date, station, cost | Free |
| 💳 Digital Wallet | Store payment methods, buy credit bundles | Free |
| ⭐ Loyalty Program | Earn points per wash → unlock rewards and discounts | Free |
| 🔔 Notifications | Wash complete alerts, nearby station alerts, promotions | Free |
| 🏆 Achievements | Earn badges: First Wash, 10 Washes, Eco Warrior, etc. | Free |
| 📈 Eco Impact | Track water saved, CO₂ reduced vs. manual washing | Free |
| 🔗 Fleet Mode | Manage multiple bikes, add team members, bulk credits | Pro |
| 📊 Fleet Analytics | Usage reports, cost breakdown, maintenance alerts | Pro |
Loyalty Tiers
| Tier | Requirement | Benefits |
|---|---|---|
| 🥉 Bronze | 0 washes | Base pricing, earn 1 point/wash |
| 🥈 Silver | 10 washes | 5% discount, earn 1.5 points/wash, priority support |
| 🥇 Gold | 50 washes | 10% discount, earn 2 points/wash, free care product sample |
| 💎 Platinum | 200 washes | 20% discount, earn 3 points/wash, VIP access, free annual service |
Troubleshooting
1. Ensure camera permissions are enabled (Settings → cycleWASH → Camera → Allow)
2. Clean the QR code on the machine if dirty
3. Try holding your phone 15-20cm from the code
4. If still not working, tap "Enter Code Manually" and type the 8-digit station code displayed below the QR
1. Check your payment method is valid (Profile → Payment Methods)
2. Ensure sufficient balance on your card or wash credit account
3. Try a different payment method (Apple Pay, card, PayPal)
4. If using credit bundles, check your remaining balance
5. Contact support: info@cyclewash.de
1. Force close the app: swipe up from bottom, swipe the app away
2. Check for updates: App Store → Profile → cycleWASH → Update
3. Restart your iPhone
4. Delete and reinstall the app (your account data is cloud-synced)
5. Minimum requirement: iOS 15.0, iPhone 8 or newer
API & Code Documentation
Theme Architecture
cyclewash-theme-v3/ ├── layout/ │ └── theme.liquid # Master layout — SEO meta, JSON-LD, chat agent ├── templates/ # 48 Shopify page templates │ ├── index.json # Homepage │ ├── blog.json # Blog listing │ ├── article.json # Individual articles │ ├── product.json # Product pages │ └── page.*.json # 38+ custom pages ├── sections/ # 100+ modular Liquid sections │ ├── cw-header.liquid # Navigation │ ├── cw-footer.liquid # Footer │ ├── cw-hero.liquid # Hero banners │ ├── cw-chat-agent.liquid # AI Chat widget │ └── cw-*.liquid # All custom sections ├── snippets/ # 55 reusable components │ ├── meta-tags.liquid # SEO tags │ ├── cw-crm-dashboard.liquid # CRM interface │ └── cw-page-*.liquid # Product page bodies ├── config/ │ ├── settings_schema.json # Theme settings UI │ └── settings_data.json # Current theme values ├── locales/ # 10 language files (DE,EN,FR,ES,IT,NL,JA,KO,PT,ZH) └── assets/ # CSS, JS, images, PDFs
Shopify CLI Commands
# Push theme to live store
npx shopify theme push --theme 189228155146 --allow-live --nodelete
# Preview theme locally
npx shopify theme dev --theme 189228155146
# Pull latest theme from Shopify
npx shopify theme pull --theme 189228155146
# Run theme check (linting)
npx shopify theme check
# Create a blog post via GraphQL
npx shopify store execute --store cyclewash.myshopify.com --allow-mutations --query '
mutation {
articleCreate(article: {
blogId: "gid://shopify/Blog/118161146122"
title: "Your Post Title"
handle: "your-post-slug"
body: "<h2>Content here</h2><p>HTML body...</p>"
author: { name: "cycleWASH Engineering" }
tags: ["Technology", "Solar"]
isPublished: true
publishDate: "2026-04-10T10:00:00Z"
}) {
article { id handle }
userErrors { field message }
}
}'
# Create a page via GraphQL
npx shopify store execute --store cyclewash.myshopify.com --allow-mutations --query '
mutation {
pageCreate(page: {
title: "Page Title"
handle: "page-slug"
templateSuffix: "template-name"
body: "<p>Content</p>"
isPublished: true
}) {
page { id handle }
userErrors { field message }
}
}'
i18n Pattern (8 Languages)
<!-- Use in HTML --> <h2>Italian translation</h2>
JSON-LD Schema Types Used
| Schema | Location | Purpose |
|---|---|---|
| Organization | theme.liquid | Company info, patents, social profiles |
| WebSite | theme.liquid | Search action, sitelinks |
| LocalBusiness | theme.liquid | Address, hours, geo coordinates, offers |
| BreadcrumbList | theme.liquid | Page hierarchy for search results |
| Product | meta-tags.liquid + snippets | Product name, price, availability |
| FAQPage | cw-faq.liquid | Question/answer pairs |
| VideoObject | cw-videos.liquid | Embedded video metadata |
| BlogPosting | cw-article.liquid | Blog post with author, date, word count |
| Blog | cw-blog.liquid | Blog listing with post array |
Key Configuration
| Setting | Value | Location |
|---|---|---|
| Theme ID | 189228155146 | Shopify Admin |
| Store | cyclewash.myshopify.com | Shopify |
| Domain | shop.cyclewash.com | DNS |
| Blog ID | gid://shopify/Blog/118161146122 | GraphQL |
| Brand Blue | #1E82C8 | CSS --cw-blue |
| Brand Gold | #FFC300 | CSS --cw-gold |
| Admin Password | admin75 | page.admin.json |
| Languages | DE, EN, FR, ES, IT, NL, JA, KO, ZH-CN | locales/ |
Shipping & Payments
Shipping Zones & Rates
| Zone | Countries | Machine Rate | Care Products | Delivery |
|---|---|---|---|---|
| 🇩🇪 Germany | Germany | FREE (>€10k) | FREE | 2-5 days |
| 🇪🇺 EU Nearby | AT, NL, BE, LU, FR, DK, CZ, PL | from €149 | €19 | 5-8 days |
| 🇪🇺 EU Far | ES, IT, PT, GR, RO, SE, FI, NO | from €249 | €29 | 7-12 days |
| 🇨🇭 Switzerland | Switzerland | from €199 | €35 | 5-8 days |
| 🇬🇧 UK | United Kingdom | from €249 | €35 | 7-10 days |
| 🇺🇸 US East | Eastern US states | from $499 | $49 | 10-15 days |
| 🇺🇸 US West | Western US states | from $599 | $49 | 12-18 days |
| 🇯🇵🇰🇷 Asia | Japan, South Korea | from €599 | €59 | 10-15 days |
| 🇦🇪 Middle East | UAE, Saudi Arabia | from €549 | €49 | 8-12 days |
| 🌍 Rest of World | All other countries | Custom quote | €65 | 15-25 days |
Payment Methods
| Method | Type | Regions | Status |
|---|---|---|---|
| Shopify Payments | Visa, MC, Amex | Worldwide | ✅ Active |
| Shop Pay | Accelerated checkout | Worldwide | ✅ Active |
| Apple Pay | Mobile NFC | Worldwide | ✅ Active |
| Google Pay | Mobile NFC | Worldwide | ✅ Active |
| PayPal | Digital wallet | Worldwide | ✅ Active |
| Sharpei | Leasing / Rental | EU, US | ✅ Integrated |
| Bank Transfer | B2B Invoice | EU | On request |
| Klarna | Buy Now Pay Later | EU, US | Recommended |
B2B Purchase Process
Request a Quote
Contact us via the form at /pages/contact-us, email info@cyclewash.de, or use the chat widget. Specify model, quantity, and delivery location.
Receive Proposal
We'll send a detailed proposal within 24 hours including product pricing, shipping costs, installation plan, and payment terms (NET 30/60/90 available for qualified buyers).
Order & Payment
Place your order online (Shopify checkout) or via signed purchase order. Payment options: full upfront, 50/50 split, or leasing via Sharpei.
Delivery & Installation
Manufacturing: 2-4 weeks. Shipping per zone table above. For OASIS stations, our team handles on-site installation (2-3 days).
Frequently Asked Questions
Just 3-5 liters per wash cycle — 95% less than manual bike washing (80+ liters). Our water recycling system reclaims up to 85% of used water.
Yes! Our calibrated low-pressure spray system is specifically designed for e-bikes and carbon frames. Unlike pressure washers, our system never exceeds safe pressure levels for electronics and delicate materials.
Mini: 45 seconds. Pro: 60 seconds. OASIS: 90 seconds (includes pre-rinse and air dry). The machine handles everything automatically — just place your bike and press start.
Yes. Solar models include a LiFePO4 battery bank that stores enough energy for 20-40 washes on a full charge. Battery models work independently of sunlight. The system automatically switches between solar, battery, and optional grid backup.
Typical ROI: 8-18 months depending on location and pricing. At €3/wash with 50 washes/day, a Mini generates ~€4,500/month revenue. Use our ROI Calculator for a custom estimate.
Yes! Through our partner Sharpei, we offer flexible leasing from €199/month (Mini) or €299/month (Pro). Revenue-share models are also available — zero upfront investment, you pay per wash.
Our proprietary 100% biodegradable cleaning solution (cycleWASH EcoClean). It's pH-neutral, safe for all bike surfaces including carbon, paint, and rubber. Available in 5L and 20L containers from our Care Products page.
Absolutely. The SPIRIT API integrates with all major fleet management systems. We provide REST API + MQTT endpoints for real-time monitoring. See the SPIRIT documentation for API details.
2-year standard warranty on all machines. Extended warranty (3 or 5 years) available. Covers manufacturing defects, motor, pumps, and electronics. Brushes and consumables excluded. On-site service available in Germany and EU.
All machines are designed and manufactured at our facility in Cologne, Germany (CW Cleaning Solutions GmbH, Belfortstraße 8, 50668 Cologne). We control the entire supply chain for consistent quality. 32+ international patents protect our technology.