- TypeScript 90.2%
- CSS 8.7%
- JavaScript 0.8%
- HTML 0.2%
| .github/workflows | ||
| docs | ||
| scripts | ||
| src | ||
| .dockerignore | ||
| .editorconfig | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| CHANGELOG.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| docker-compose.yml | ||
| Dockerfile | ||
| EQUIPMENT_PRICING_REFERENCE.csv | ||
| index.html | ||
| LICENSE | ||
| nginx.conf | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| report_sample.pdf | ||
| ROADMAP.md | ||
| SECURITY.md | ||
| solar_planner_logo.svg | ||
| SPEC.md | ||
| tsconfig.json | ||
| USER_MANUAL.md | ||
Hello Solar Planner
Hello Solar Planner helps community teams and practitioners estimate solar power systems for connectivity hubs. Enter your appliances, compare power options, review equipment and costs, and share a planning report.
The planner compares two options:
- Fully DC supplies devices through DC distribution. Listed AC appliances would need suitable DC replacements.
- Hybrid DC + AC supplies DC devices directly and AC appliances through an inverter.
Each option has its own equipment, prices and checks. Your appliance values remain the basis of the estimate.
Latest published release: v1.4.0. Read the release notes for changes and existing-project guidance.
Get Started
Open Hello Solar Planner in your browser. Use the planner address provided by your organization.
- Choose New Project or explore the Sample.
- Enter your site details and appliance loads.
- Click Calculate.
- Compare the two options and review their equipment checks.
- Adjust equipment or enter local quotations for the selected option.
- Click Generate Report, then save a PDF or export CSV.
See the user manual for detailed instructions.
What You Can Plan
- Daily energy, running power, startup demand and critical-load energy
- Battery storage, usable energy and estimated autonomy
- Solar array, charge controller and inverter requirements
- Independent equipment and cost estimates for both system options
- Selectable panel, battery and controller sizes with reference prices
- Required, installed and excess capacity for reviewing equipment fit
- Optional startup, battery and PV details under advanced settings
- Equipment checks marked passed, failed or unverified
- Reports with assumptions, specification sources, costs and unresolved checks
Generated plans compare complete equipment costs and favor closer combined capacity fit within 10% of the cheapest eligible combination. Existing safety margins remain included. This selection rule adds no percentage charge.
A plan remains exportable when equipment information is incomplete. Needs attention identifies a failed check or missing information that requires review.
Understand Your Estimate
| Guide | What it explains |
|---|---|
| User manual | Entering loads, editing equipment, saving projects and sharing reports |
| Calculation guide | Formulas, loss factors, equipment selection and model limits |
| Pricing guide | African market planning estimates and local quotations |
| Roadmap | Planned improvements and contribution opportunities |
| Release history | Changes in published releases |
Prices are indicative African market planning estimates. A ±10% variation around the listed estimates may be used for initial budgeting; this is a planning assumption, not a measured market range or a verified comparison with global averages. Actual costs may fall outside this range. Confirm current local quotations before procurement.
The optional ±10% range does not automatically change planner totals. It is separate from the existing contingency allowance; do not add it again as a contingency for the same cost uncertainty. See the pricing guide for details. Final design and installation require review by a qualified solar or electrical technician.
Your Data
Projects are saved in the browser you use. There are no accounts or automatic transfers between devices. Clearing browser data can remove saved projects.
PDF and CSV exports provide portable records of a plan; they cannot currently be imported to restore an editable project. The default deployment has no telemetry and does not upload project data.
Open Source and Hosting
Hello Solar Planner is an open-source project by Project Hello World, available under the MIT License.
For development or hosting, use the contributor guide and deployment guide. Implementation, validation and maintenance records are listed in the maintainer documentation.
See the Code of Conduct when participating and the security policy to report a vulnerability.