Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Contributing to the FTW website

Sourceful develops this project. Fredrik owns FTW's product direction in
[the shared vision](https://github.com/srcfl/ftw/blob/master/VISION.md). External users submit
[issues](https://github.com/srcfl/ftw-web/issues) with bugs, needs and evidence.
We do not accept external pull requests, including documentation changes.
Acceptance of an issue does not invite an external implementation PR.

Describe the expected result, what happened, the version and relevant
hardware. You do not need to write code. Keep credentials, keys and private
site data out of public reports. Sourceful selects and implements changes.

Existing license rights and copyright attributions remain unchanged.
Sourceful implementation PRs should state the user need, coordinate overlap,
include relevant verification and follow the repository's development guide.
13 changes: 13 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,19 @@ The legacy `home.fortytwowatts.com` host is not part of the website redirect.
It remains a WebAuthn security identity until the separate passkey migration is
complete.

## Product direction and contribution policy

Use [FTW's vision](https://github.com/srcfl/ftw/blob/master/VISION.md) and
[roadmap](https://github.com/srcfl/ftw/blob/master/docs/roadmap.md) when writing product copy.
Explain mixed-equipment coordination, simple defaults, local control and
visible outcomes. Clearly distinguish implemented capabilities from goals
such as cloud MCP. Do not publish predicted savings as measured results.

Sourceful maintains the product; Fredrik owns its direction. External users
submit [issues](https://github.com/srcfl/ftw-web/issues), not PRs, including
copy corrections. See [CONTRIBUTING.md](CONTRIBUTING.md). Keep existing license
and historical attribution intact. Inspect rendered copy before publishing.

## Local dev

```bash
Expand Down
30 changes: 15 additions & 15 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>FTW | Open-source home energy management</title>
<meta name="description" content="FTW is an Apache-2.0, self-hosted home energy management system. Coordinate solar, batteries, grid and EV charging locally with a Go runtime and community-built Lua drivers.">
<meta name="description" content="FTW is an Apache-2.0, self-hosted home energy management system. Coordinate solar, batteries, grid and EV charging locally with a Go runtime and Sourceful-maintained Lua drivers.">
<meta name="keywords" content="FTW, home energy management, HEMS, open source, self-hosted, solar, battery, EV charging, Raspberry Pi, Go, Lua, Home Assistant">
<meta name="robots" content="index,follow">
<meta name="author" content="Sourceful Energy and FTW contributors">
<meta name="author" content="Sourceful Energy">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Preserve contributors in the author metadata

This removes FTW contributors from the page's authorship record even though this change also instructs maintainers to keep historical attribution (README.md:24-27), and the footer still acknowledges contributor copyright. Crawlers and catalogs that consume the author metadata will now attribute the project solely to Sourceful; distinguish current maintenance ownership elsewhere while retaining contributors in this author field.

Useful? React with 👍 / 👎.

<meta name="theme-color" content="#0a0a0a">
<link rel="canonical" href="https://ftw.sourceful.energy/">

Expand Down Expand Up @@ -71,7 +71,7 @@
<section class="hero" id="top">
<div class="wrap hero-layout">
<div class="hero-copy">
<p class="project-state"><span class="status-dot" aria-hidden="true"></span>Apache-2.0 · Self-hosted · Community maintained</p>
<p class="project-state"><span class="status-dot" aria-hidden="true"></span>Apache-2.0 · Self-hosted · Sourceful maintained</p>
<h1>Your home energy, coordinated <em>in the open.</em></h1>
<p class="hero-lede">FTW is a local-first home energy management system for solar, batteries, grid and EV charging. Run it on your own hardware, inspect every decision and teach it new devices in Lua.</p>
<div class="hero-actions">
Expand Down Expand Up @@ -129,7 +129,7 @@ <h2>Start with the software, not a sales call.</h2>
<a href="https://github.com/srcfl/ftw/blob/master/docs/rpi-image.md"><span>01</span>Raspberry Pi image <b>Recommended</b></a>
<a href="https://github.com/srcfl/ftw#install-on-linux"><span>02</span>Docker installer <b>Debian / Ubuntu</b></a>
<a href="https://github.com/srcfl/ftw#install-on-home-assistant"><span>03</span>Home Assistant <b>Add-on</b></a>
<a href="https://github.com/srcfl/ftw#local-development"><span>04</span>Build from source <b>Contributors</b></a>
<a href="https://github.com/srcfl/ftw#local-development"><span>04</span>Build from source <b>Developers</b></a>
</div>
</div>
</section>
Expand Down Expand Up @@ -204,8 +204,8 @@ <h3>Failure-aware by design</h3>
<article>
<span class="cap-number">05 / STORE</span>
<h3>Keep the history</h3>
<p>SQLite telemetry and compressed Parquet rolloff keep detailed energy data under operator control.</p>
<code>SQLite · Parquet</code>
<p>Detailed energy history stays on the box, with storage and recovery managed by FTW Core.</p>
<code>Local history · Core</code>
</article>
<article>
<span class="cap-number">06 / CONNECT</span>
Expand All @@ -225,7 +225,7 @@ <h2>New hardware should be a driver, not a fork.</h2>
<ul class="check-list">
<li>Start from an existing inverter, meter or charger driver</li>
<li>Test with simulators and the same public host API</li>
<li>Contribute the integration back through a pull request</li>
<li>Share device needs and test evidence through an issue</li>
</ul>
<div class="inline-actions">
<a class="text-link" href="https://github.com/srcfl/device-drivers/blob/main/docs/WRITING-A-DRIVER.md">Write a driver <span aria-hidden="true">→</span></a>
Expand All @@ -247,7 +247,7 @@ <h2>New hardware should be a driver, not a fork.</h2>
})
<span class="code-key">return</span> <span class="code-number">1000</span>
<span class="code-key">end</span></code></pre>
<div class="code-footer"><span>hot-editable</span><span>no build step</span><span>PRs welcome</span></div>
<div class="code-footer"><span>hot-editable</span><span>no build step</span><span>Issues welcome</span></div>
</div>
</div>
</section>
Expand All @@ -256,9 +256,9 @@ <h2>New hardware should be a driver, not a fork.</h2>
<div class="wrap community-layout">
<div class="community-intro">
<p class="section-kicker">The community edition</p>
<h2>Free software, shared stewardship.</h2>
<p>Run FTW at home, study it, modify it and use it commercially under Apache-2.0. Development happens in public and Sourceful Energy maintains the core together with project contributors.</p>
<div class="license-line"><span>Apache-2.0</span><span>Public roadmap</span><span>Community PRs</span></div>
<h2>Open source, maintained by Sourceful.</h2>
<p>Run FTW at home, study it, modify it and use it commercially under Apache-2.0. Sourceful Energy develops and maintains FTW. External users help through issues with bugs, needs and evidence. We do not accept external pull requests.</p>
<div class="license-line"><span>Apache-2.0</span><span>Public roadmap</span><span>Community issues</span></div>
</div>
<div class="community-panels">
<article>
Expand All @@ -274,10 +274,10 @@ <h3>You operate what you run.</h3>
<article>
<span class="panel-tag">Contribute</span>
<h3>Make the shared system better.</h3>
<p>Add a device, reproduce a hardware edge case, improve the planner or sharpen the docs. Open an issue before a large change, then build in public.</p>
<p>Report a device need, reproduce a hardware problem or suggest a clearer flow. Open an issue with what you want to achieve; Sourceful handles implementation, including documentation and drivers.</p>
<div class="panel-links">
<a href="https://github.com/srcfl/ftw/blob/master/CONTRIBUTING.md">Contribution guide <span aria-hidden="true">↗</span></a>
<a href="https://github.com/srcfl/ftw/pulls">Pull requests <span aria-hidden="true">↗</span></a>
<a href="https://github.com/srcfl/ftw/issues">Report an issue <span aria-hidden="true">↗</span></a>
</div>
</article>
</div>
Expand Down Expand Up @@ -308,7 +308,7 @@ <h2>Open code. Commercial accountability.</h2>
<h2>Energy infrastructure you can own.</h2>
</div>
<div>
<p>Install it. Read it. Break it safely. Send the fix upstream.</p>
<p>Run it. Explore it. Tell us what would make it better.</p>
<div class="hero-actions">
<a class="btn btn-primary" href="https://github.com/srcfl/ftw#install-on-linux">Get started <span aria-hidden="true">→</span></a>
<a class="btn btn-ghost" href="https://github.com/srcfl/ftw">Star on GitHub <span aria-hidden="true">↗</span></a>
Expand All @@ -322,7 +322,7 @@ <h2>Energy infrastructure you can own.</h2>
<div class="wrap footer-main">
<div class="footer-brand">
<img src="/favicon.svg" alt="" width="38" height="38">
<div><strong>FTW</strong><span>An open-source project maintained by Sourceful Energy and contributors.</span></div>
<div><strong>FTW</strong><span>An open-source project maintained by Sourceful Energy.</span></div>
</div>
<div class="footer-links">
<div><span>Project</span><a href="https://github.com/srcfl/ftw">GitHub</a><a href="https://github.com/srcfl/ftw/releases">Releases</a><a href="https://github.com/srcfl/ftw#documentation">Documentation</a></div>
Expand Down