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
6 changes: 4 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,10 @@ this app is a cached projection of it.
## Shared product direction

[FTW's vision](https://github.com/srcfl/ftw/blob/master/VISION.md) governs the native client.
Fredrik owns the direction and Sourceful develops it. External users submit
issues, not PRs; see [CONTRIBUTING.md](CONTRIBUTING.md).
Fredrik owns the direction and Sourceful develops it. External PRs are
welcome, preferably based on issues. Work is agentic first: state the problem,
scope and reproducible results. Code and short Markdown proposals follow
[CONTRIBUTING.md](CONTRIBUTING.md).

The full product aims for clear live command/outcome feedback, simple charging
and useful notifications. Those goals do not remove the current native release
Expand Down
33 changes: 20 additions & 13 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,22 @@
# Contributing to the FTW native app

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-app/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.
Sourceful maintains this repository. Fredrik owns FTW's direction in
[the shared vision](https://github.com/srcfl/ftw/blob/master/VISION.md).
External PRs are welcome, preferably based on an
[issue](https://github.com/srcfl/ftw-app/issues). Small fixes need no separate issue.

Broad product or architecture ideas may start as short Markdown PRs in the
PR description or relevant maintained docs. Mark proposed behaviour as
proposed. Concrete fixes can include code and tests. Keep task breakdowns
and agent scratch notes out of the repository.

Work is agentic first: give people and agents a clear problem, scope,
reproducible test steps and actual results. Check agent output before
submitting it. Test changed behaviour and review changed UI in a browser.

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 Require UI review on the native targets

For changes to the SwiftUI or Jetpack Compose interfaces, a browser cannot render or exercise the modified UI because this repository produces native iOS and Android apps rather than a web application. Contributors following this instruction could therefore report completing the required review without ever seeing the changed screen; specify an iOS simulator/device and Android emulator/device as appropriate instead.

Useful? React with 👍 / 👎.

Hardware claims need relevant hardware evidence; distinguish simulation
from physical tests and state missing checks. Docs need no hardware tests.
Follow the repository guide and coordinate overlap with open PRs.

Sourceful reviews and maintains changes. A contribution grants no merge,
release or deployment authority. Existing license rights and attribution
remain unchanged. See [FTW's contribution guide](https://github.com/srcfl/ftw/blob/master/CONTRIBUTING.md).
5 changes: 3 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,9 @@ few routine choices, honest live feedback and reliable daily charging.
The native status below is a dated record and its verification gates still
apply; the vision does not declare new native features shipped.

Sourceful develops this app. External users submit
[issues](https://github.com/srcfl/ftw-app/issues), not pull requests.
Sourceful develops this app. PRs are welcome, preferably based on
[issues](https://github.com/srcfl/ftw-app/issues). Share a short Markdown
proposal or a focused fix with relevant test evidence.
See [CONTRIBUTING.md](CONTRIBUTING.md).

## Shape
Expand Down