Skip to content

Teycir/SolarClose

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

279 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Support Development

If this project helps your work, support ongoing maintenance and new features.

ETH Donation Wallet
0x11282eE5726B3370c8B480e321b3B2aA13686582

Ethereum donation QR code

Scan the QR code or copy the wallet address above.

SolarClose - The Offline-First Solar Calculator

SolarClose Screenshot

Solar Privacy Offline License

๐ŸŒŸ Start Using Now: https://solarclose.pages.dev

The Solar Sales Tool That Respects Your Data.

Most solar software runs in the cloud, meaning they own your leads. SolarClose is different. It runs entirely on your iPad/Laptop.

SolarClose is open source software licensed under BSL 1.1.

  • Privacy First: All data stays on your device. Zero data leaves your browser.
  • Free Web Version: Try it at https://solarclose.pages.dev
  • Open Source: View and modify the code under BSL 1.1 license
  • Commercial Licensing: Available for companies with $1M+ revenue

๐Ÿ“š Documentation: Features | Calculations | PWA Setup | QR Handoff | Signatures


๐Ÿš€ Complete Feature List

Core Sales Features

โœ… 100% Offline Operation - Close deals in basements, rural areas, or anywhere without signal
โœ… Instant ROI Calculations - Show 25-year savings in real-time. Zero loading screens
โœ… Privacy Guaranteed - Your leads live on your device. We never see them
โœ… Professional PDF Proposals - Generate branded client proposals and technical sales sheets
โœ… Quick Copy Summary - One-click to copy formatted talking points for texting prospects
โœ… Smart Lead Tracking - "Last Contacted" timestamps prevent duplicate visits
โœ… Lead Search & Filter - Instantly find customers by name or address
โœ… Show Mode - Full-screen theatrical presentation for client reveals
โœ… Digital Signatures - Capture client and sales rep signatures
โœ… Lead Notes - Store detailed notes and comments on each lead

Financial Analysis

๐Ÿ’ฐ Monthly Payment Comparison - Old utility bill vs. Solar + Loan payment side-by-side
๐Ÿ’ฐ 25-Year Savings Projection - Total lifetime savings with visual timeline chart
๐Ÿ’ฐ Break-Even Point (ROI) - Highlighted on timeline showing when system pays for itself
๐Ÿ’ฐ Customizable Loan Terms - APR, term length, down payment, and dealer fees
๐Ÿ’ฐ Inflation Modeling - 4% annual utility rate increase (customizable)
๐Ÿ’ฐ Maintenance Costs - Optional $150/yr maintenance factor
๐Ÿ’ฐ Inverter Replacement - Factored at Year 12 & 24 (customizable cost)
๐Ÿ’ฐ Panel Degradation - 0.5% annual output decline built-in

Technical Calculations

โšก System Sizing - Input system size in kW with automatic production estimates
โšก Real Efficiency Derating - 80% derating (weather/shade/inverter loss)
โšก Annual Production - kWh/year based on system size and location factors
โšก Offset Percentage - Shows how much of electric bill is covered by solar
โšก Environmental Impact - COโ‚‚ offset and trees planted equivalent calculations

Multi-Language Support

๐ŸŒ 5 Complete Languages - English, Spanish, Italian, French, German
๐ŸŒ Localized PDFs - Client proposals in customer's native language
๐ŸŒ Currency Formatting - Automatic $/โ‚ฌ based on language
๐ŸŒ Date Formatting - US/EU styles (MM/DD/YYYY vs DD/MM/YYYY)
๐ŸŒ Per-Lead Language - Each customer remembers their language preference
๐ŸŒ Instant Switching - One-click language toggle in top-left corner

User Experience

๐ŸŽจ Glass-Morphism Design - Modern, professional interface that looks expensive
๐ŸŽจ Animated Counters - Smooth number animations for savings displays
๐ŸŽจ Progress Bars - Visual indicators for system offset and ROI
๐ŸŽจ Confetti Celebrations - Trigger on high savings to create excitement
๐ŸŽจ Show Mode - Full-screen theatrical presentation view for client reveals
๐ŸŽจ Responsive Layout - Works perfectly on iPad, tablets, and laptops
๐ŸŽจ Dark Mode Ready - Beautiful on any device in any lighting

Data Management

๐Ÿ’พ Auto-Save - Every input automatically saved to local storage ๐Ÿ’พ JSON Backup/Restore - Export all leads to universal JSON format ๐Ÿ’พ Import Leads - Restore from backup or migrate devices ๐Ÿ’พ Delete Leads - Individual lead deletion with confirmation ๐Ÿ’พ QR Code Handoff - Generate QR codes linking to SolarClose website ๐Ÿ’พ Digital Signatures - Capture client signatures with touch/mouse (native Canvas, no libraries) ๐Ÿ’พ No Cloud Dependency - All data stays on your device forever

PDF Export

๐Ÿ“„ Dual PDF Generation - Client proposal + Technical sales sheet
๐Ÿ“„ Branded Design - Professional layout with your company info
๐Ÿ“„ Multi-Language PDFs - Proposals in customer's language
๐Ÿ“„ Detailed Breakdown - Monthly costs, savings, and 25-year projections
๐Ÿ“„ Environmental Stats - COโ‚‚ and tree equivalents in PDFs
๐Ÿ“„ Instant Download - No server processing, generated in-browser

Progressive Web App (PWA)

๐Ÿ“ฒ Install to Home Screen - Works like a native app
๐Ÿ“ฒ Offline-First Architecture - Full functionality without internet
๐Ÿ“ฒ Fast Loading - Instant startup, no server delays
๐Ÿ“ฒ Cross-Platform - iOS, Android, Windows, macOS, Linux
๐Ÿ“ฒ Auto-Updates - Latest features delivered automatically


๐Ÿ“ฑ How It Works

1. Enter Customer Info

Type in the name and address. Everything auto-saves to your device's local storage.

2. Build the System

Input system size (kW), total cost, and current electric bill.

3. Show the Savings

Instantly display:

  • Monthly payment swap (Old Bill vs. Solar + Loan)
  • 25-Year Total Savings with visual chart
  • Break-even point (ROI) highlighted on timeline
  • Environmental impact (COโ‚‚ offset, trees planted equivalent)
  • One-click "Copy Summary" to text prospects

4. Close the Deal

Click "๐ŸŽญ Show" to:

  • Theatrical View: Full-screen presentation mode with big numbers
  • Client Reveal: Turn your device around and say "Here is your future"
  • Distraction-Free: Hides all inputs, shows only key results
  • Press ESC to Exit: Quick return to editing mode

Click "Export PDF" to generate:

  • Client Proposal: A clean, branded PDF for the homeowner (in their language)
  • Sales Sheet: A detailed technical breakdown for your records

Or click "๐Ÿ“ฑ QR Code" to:

  • Instant Handoff: Generate a QR code linking to SolarClose website
  • Mobile-Friendly: Client scans to visit the site on their device
  • Easy Access: Quick way to share the calculator with prospects

5. Track & Follow Up

  • Last Contacted timestamps on every lead
  • Never knock the same door twice by mistake
  • Prioritize follow-ups at a glance

๐ŸŽฏ Perfect For

  • Door-to-Door Reps: No signal? No problem. Works 100% offline
  • Multi-Language Markets: Serve Spanish, Italian, French, and German customers with native-language proposals
  • Privacy-Conscious Teams: Stop feeding your lead data to SaaS aggregators
  • Speed Closers: When you don't have 15 minutes to wait for a complex CAD design
  • Text-First Closers: Copy formatted savings to text prospects instantly

๐Ÿ’ก Calculation Methodology (Auditable)

We don't hide our math. We use realistic, conservative numbers to build trust:

  • Real Efficiency: 80% derating (accounts for weather/shade/inverter loss)
  • Degradation: 0.5% annual panel output decline
  • Maintenance Buffer: Optional $150/yr maintenance factor
  • Inverter Replacement: Factored at Year 12 & 24 (customizable)
  • Inflation: 4% annual utility rate increase (customizable)

All calculations use industry-standard formulas and conservative assumptions.


๐ŸŒ Multi-Language Support

Fully localized in 5 languages - Not just the UI, but everything:

  • ๐Ÿ‡บ๐Ÿ‡ธ English - Complete interface, PDFs, and calculations
  • ๐Ÿ‡ช๐Ÿ‡ธ Spanish (Espaรฑol) - Perfect for US Hispanic markets and Latin America
  • ๐Ÿ‡ฎ๐Ÿ‡น Italian (Italiano) - Serve Italian-speaking customers
  • ๐Ÿ‡ซ๐Ÿ‡ท French (Franรงais) - For French-speaking markets
  • ๐Ÿ‡ฉ๐Ÿ‡ช German (Deutsch) - Complete German localization

What's translated:

  • โœ… Entire user interface
  • โœ… PDF proposals (client-facing)
  • โœ… PDF sales sheets (internal)
  • โœ… All form labels and buttons
  • โœ… Error messages and tooltips
  • โœ… Currency formatting ($/โ‚ฌ)
  • โœ… Date formatting (US/EU styles)

Switch languages instantly - One click in the top-left corner. Your leads remember their language preference.


๐Ÿ”’ Security & Backup

Your Data, Your Device.

  • Local Storage: All data persists in your browser. Clearing cookies clears data
  • JSON Backup: Click "Backup" to download a universal JSON file of your leads
  • Cloud Freedom: Save that backup to your Google Drive, not ours

๐Ÿ“œ License & Pricing

SolarClose is open source software licensed under the Business Source License 1.1 (BSL).

๐Ÿ†“ Free Use

  • Personal Use: Free forever
  • Commercial Use: Free for companies with less than $1M annual revenue
  • Self-Hosting: Allowed under BSL terms
  • Modifications: Allowed for internal use

๐Ÿข Commercial License

For companies with $1M+ annual revenue:

  • White-Label Branding: Your company logo, colors, and domain
  • Custom Features: Pre-loaded incentives, loan products, and integrations
  • Priority Support: Direct technical assistance
  • Commercial Rights: Full commercial usage rights

Contact us for Commercial Licensing

โš–๏ธ License Conversion

After 4 years from release, the software automatically converts to the Apache 2.0 license, making it fully open source.

See LICENSE for full terms.


๐Ÿ“ฒ Installation

Web App (Recommended):

Self-Hosted Deployment:

git clone https://github.com/yourusername/solarclose.git
cd solarclose
npm install
npm run build
npm start

โš–๏ธ Legal Notice

SolarClose is licensed under the Business Source License 1.1 (BSL).

ยฉ 2025 SolarClose. Licensed under BSL 1.1.

This software is open source under the Business Source License 1.1. You may use, modify, and distribute this software for non-production purposes or for companies with less than $1M annual revenue. After 4 years from release, the license automatically converts to Apache 2.0.

Commercial use by companies with $1M+ annual revenue requires a commercial license.

For licensing inquiries, contact: https://teycirbensoltane.tn

Made by Teycir - https://teycirbensoltane.tn

About

Solar energy economy calcullator

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors