Skip to content

docs: register Trade Republic Importer as a community directory addon - #5

Merged
afadil merged 10 commits into
wealthfolio:mainfrom
blastik:feat/trade-republic-importer-addon
Aug 21, 2026
Merged

docs: register Trade Republic Importer as a community directory addon#5
afadil merged 10 commits into
wealthfolio:mainfrom
blastik:feat/trade-republic-importer-addon

Conversation

@blastik

@blastik blastik commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Registers the Trade Republic Importer as a community directory listing (community/directory/) — a discovery entry, not a Verified Community submission. It doesn't have the screenshots or pinned-source/distribution build that Verified status requires yet, so it matches the plain unverified template used by the other community directory addons here.

This addon imports Trade Republic CSV exports into Wealthfolio. It maps each transaction type to the correct Wealthfolio activity and splits activities across a cash account and a securities account, automatically generating the internal transfers needed to keep both balances consistent — including tagging those transfers with sourceGroupId so they're correctly excluded from Wealthfolio's spending totals.

Supported transaction types: deposits, withdrawals, card transactions, interest, Saveback rewards, dividends (including foreign-currency with FX rate), buy/sell trades, broker transfers, and Stockperk gifts.

Repository: https://github.com/blastik/trade-republic-importer-addon
Latest release: https://github.com/blastik/trade-republic-importer-addon/releases/tag/v1.2.0 (migrated to Wealthfolio Addon SDK 3.6.1's sandboxed-iframe addon runtime; requires Wealthfolio 3.6.0+)
Changelog: https://github.com/blastik/trade-republic-importer-addon/blob/main/CHANGELOG.md

Test plan

  • pnpm validate:addons — no errors
  • pnpm generatecommunity/README.md regenerated

blastik added 2 commits July 4, 2026 18:19
Community-contributed addon by blastik. Imports Trade Republic CSV
exports into Wealthfolio with two-account model and transfer detection.
Source: https://github.com/blastik/trade-republic-importer-addon v1.0.0

Claude-Session: https://claude.ai/code/session_01Qe6ZBdCPMLcZhuFGMsXsm7
- Account dropdowns filter by type (CASH / SECURITIES only)
- Multi-currency: cash symbol and currency derived from account, not hardcoded EUR

Claude-Session: https://claude.ai/code/session_019iQ6pzBhXjaTJPe6FbJB1m
@blastik blastik changed the title chore: bump trade-republic-importer-addon to v1.1.0 feat: add Trade Republic Importer addon Jul 7, 2026
@blastik

blastik commented Jul 7, 2026

Copy link
Copy Markdown
Contributor Author

cc @afadil

blastik added 2 commits July 8, 2026 17:49
The previous entry lived under community/verified/ with a hand-rolled
release block (tag/commit/downloadUrl crammed into "release" instead of
split across source/distribution) that matched neither the verified nor
directory submission template from CONTRIBUTING.md, had no cover
screenshots, and was marked "unverified" despite the verified/ path.

Verified Community status requires a distribution.r2Path populated by
Wealthfolio's own build/review pipeline, not something an addon author
can self-fill — so move this to community/directory/, matching every
other unverified community addon here (id/name/description/author/
trust/verification/status/tags/repository only, no release tracking).
Users continue to install from the addon's own GitHub releases, same as
today.

Regenerated community/README.md via `pnpm generate`.
@blastik blastik changed the title feat: add Trade Republic Importer addon docs: register Trade Republic Importer as a community directory addon Jul 9, 2026
Merges main, removes the retired verification field, adds the commercial model,
and drops the generated README hunk. Adds the derived record read from the
publisher's repository.

Validation fails until the repository carries a licence: package.json says MIT
but there is no LICENSE file, so GitHub detects none and nobody has the right
to use the addon. That is the one thing left before this can be published.
@afadil

afadil commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Thanks for this, and sorry it sat so long. I introduced the addon sandbox in 3.6 and reworked how community listings work before getting to the queue, so your PR needed updating rather than just merging.

I've pushed the changes to your branch:

  • merged main, which clears the conflicts
  • removed verification, that field no longer exists
  • added "commercialModel": "free", tell me if that's wrong
  • dropped the community/README.md hunk, that file is generated now
  • added the derived record for your addon

You don't declare licence, compatibility or data handling any more. I read them from your repo. Your manifest is on SDK 3.6.1, which is what the directory needs, and it asks for no network permission, so the sandbox blocks outbound calls entirely. That lets the listing say your addon keeps data on the user's machine and have it be true, rather than repeating something you told me.

One thing is blocking it, and CI is red because of it: the repo has no LICENSE file. package.json says MIT, but GitHub only picks up a licence from the file itself, so as it stands nobody technically has the right to use or share the addon and I can't publish a listing pointing at it. Adding the MIT text fixes it and CI goes green. Happy to open that PR on your repo if it's easier, just confirm MIT is what you want.

Same applies to #6, so one licence file each and both are done.

One optional thing: your listing id is trade-republic-importer-addon but your manifest id is trade-republic-importer. Nothing breaks, but if they match I can cross-reference the directory and an installed addon later. Happy either way, your call.

Then post this as a comment and I'll merge:

I have read POLICIES.md and confirm:

- [ ] I am the publisher of this addon, or authorised to act for them.
- [ ] I have the rights to the name and description, and grant Wealthfolio permission to display them.
- [ ] The repository is public and has a licence file.
- [ ] What I declared is accurate, and my manifest declares every host the addon reaches.
- [ ] There is no hidden data collection or undisclosed remote code.
- [ ] I own support, updates, security fixes, privacy, licensing, and commercial terms.
- [ ] The name doesn't imply the addon is official or endorsed.
- [ ] A listing is a link only. Wealthfolio doesn't host, audit, endorse, or support it, and may remove it.

@blastik

blastik commented Aug 21, 2026

Copy link
Copy Markdown
Contributor Author

LICENSE file added: https://github.com/blastik/trade-republic-importer-addon/blob/main/LICENSE (matches the MIT already declared in package.json / manifest.json). GitHub now detects it as MIT.

I have read POLICIES.md and confirm:

  • I am the publisher of this addon, or authorised to act for them.
  • I have the rights to the name and description, and grant Wealthfolio permission to display them.
  • The repository is public and has a licence file.
  • What I declared is accurate, and my manifest declares every host the addon reaches.
  • There is no hidden data collection or undisclosed remote code.
  • I own support, updates, security fixes, privacy, licensing, and commercial terms.
  • The name doesn't imply the addon is official or endorsed.
  • A listing is a link only. Wealthfolio doesn't host, audit, endorse, or support it, and may remove it.

afadil added 4 commits August 21, 2026 13:22
CI validates against the committed derived.json and never touches the network,
so it could not see the LICENSE file that landed this morning. Re-running the
derivation picks it up: trade-republic-importer-addon now resolves as MIT,
SDK 3.6.1, no network permission.
…fresh

# Conflicts:
#	community/README.md
#	community/derived.json
@afadil
afadil merged commit 5031f95 into wealthfolio:main Aug 21, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants