Compare commits
678 commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 6d14eda8cc | |||
| af61adb9d1 | |||
| 73e4614b34 | |||
| 108b362cd9 | |||
| 5cc3da486d | |||
| 7e362ef962 | |||
| c1bed9440e | |||
| 793c322f99 | |||
| ab97d6d72f | |||
| c5173e4cae | |||
| f637c5e4e7 | |||
| 3a22d7f455 | |||
| 96458bba5c | |||
| b361e22631 | |||
| b18d480d65 | |||
| f6f9fc3c41 | |||
| 8573c9f6ae | |||
| 1ce4f026e9 | |||
| 73a962fbdc | |||
| b1043f5d79 | |||
| 01ea264a21 | |||
| ec381e8664 | |||
| f34192b546 | |||
| d71368e886 | |||
| 07052cffd2 | |||
| b82becf7fb | |||
| 9081ac921d | |||
| 9c001d1ca9 | |||
| 83d351cf42 | |||
| d05294ebcd | |||
| 36ef9c2c5c | |||
| 0950ef2c99 | |||
| 31f863ed06 | |||
| 64cb16e337 | |||
| 700fcc4d66 | |||
| f1a9229cf9 | |||
| 68467ffe9b | |||
| d88ed3ec55 | |||
| 1e47c2ee60 | |||
| 53d57544bf | |||
| d0f568ebc2 | |||
| cdd9321794 | |||
| 3a8d9d7551 | |||
| f5da7c9f7a | |||
| b1f1b206d3 | |||
| 4b6c28aff2 | |||
| a850ba6670 | |||
| 152e40fb8a | |||
| 724f5b9763 | |||
| 064a708fdb | |||
| 9b0cc0bf10 | |||
| 1abd0936c3 | |||
| e185b61c8e | |||
| edbcdad15d | |||
| 1c64320b65 | |||
| 6ebb656018 | |||
| f5296cc9e9 | |||
| ab69ce020c | |||
| 0ea7292164 | |||
| 02435de966 | |||
| 96ec7ba60f | |||
| 17f57c6fb6 | |||
| 3b1c6160b5 | |||
| 9620768897 | |||
| c500866295 | |||
| 398d8cd375 | |||
| a108aae53f | |||
| 164ba390dd | |||
| f2d7beb7ce | |||
| 8068993917 | |||
| 5f73fcbcf4 | |||
| 28a50e7d2e | |||
| 9a878d6562 | |||
| ef80cd2760 | |||
| bf95ee55c4 | |||
| 2dc20b61de | |||
| f64f125de6 | |||
| 5f2e03dc7d | |||
| 85cf494c0a | |||
| 4763862178 | |||
| 3dc3104bbc | |||
| 0858f4e538 | |||
| efa9503a50 | |||
| f109c519ae | |||
| cb20912f0e | |||
| db52afce1d | |||
| ae9d26d3f6 | |||
| c247b7e54a | |||
| 46c841d209 | |||
| 1953aa59d8 | |||
| 05d0e227a1 | |||
| 1030cdff0c | |||
| 5833776a4b | |||
| b59665c661 | |||
| 2c5e30090f | |||
| 304407e523 | |||
| d978bb7a8b | |||
| d7c36cbdb6 | |||
| d43c95db7e | |||
| 53845c6dd9 | |||
| da7ca48ab4 | |||
| 6782ac6078 | |||
| ed8d138a8e | |||
| 2ec1f0ab13 | |||
| a889ada137 | |||
| 5236f002f1 | |||
| 445ab1adbc | |||
| 5b6e0992ca | |||
| 0ef27cf2e4 | |||
| 98cd1d3c92 | |||
| 66247f35d9 | |||
| b059e83b90 | |||
| 61b5fa0623 | |||
| 2e1c7cdc3c | |||
| 634d5dd71d | |||
| 33a7f73ab9 | |||
| f588f4e1aa | |||
| 0263f62443 | |||
| 5fc15dd773 | |||
| 9a937b5512 | |||
| 2e8593ed5c | |||
| b325b45354 | |||
| 089c149289 | |||
| 8084104a4d | |||
| fb1609cba7 | |||
| 26f9559e1a | |||
| 4e2ffd6b3d | |||
| 1bb43fd4a0 | |||
| 29a9683ab7 | |||
| 9947ea1639 | |||
| 39b2f73ad7 | |||
| 4dff7d9b2e | |||
| 8df41a26b0 | |||
| d4cf1ad3a1 | |||
| 9ed1890de8 | |||
| 8f69a27709 | |||
| a01c78aa20 | |||
| b0641c1fc8 | |||
| 882255a32f | |||
| 84f9793af5 | |||
| 487e138f9d | |||
| 960662029e | |||
| 5b3905679b | |||
| b36b92dc90 | |||
| 0b0007045c | |||
| 12e56c5a82 | |||
| 84efa4e913 | |||
| bffbf94278 | |||
| 987f0775b3 | |||
| e2ff7efcda | |||
| 5379845e78 | |||
| 960e084bea | |||
| b1ed2ad8ca | |||
| 6abc1f65dd | |||
| f03a83bf3d | |||
| 021c0eef5a | |||
| 2e888a01cc | |||
| 06a0b424f5 | |||
| 4eac8e8cd8 | |||
| 4933279987 | |||
| 0ed7bc1ca0 | |||
| 54451c87c8 | |||
| 19b4868852 | |||
| f3e7c98994 | |||
| fa081666ec | |||
| fb37911f5e | |||
| 60a72e6947 | |||
| c03938f9dc | |||
| 7345de2f7c | |||
| 2638b90046 | |||
| f052831fea | |||
| 26ebb64458 | |||
| 83bb9a621e | |||
| 8106d7c9a2 | |||
| ffaf42c55d | |||
| 5b7b16ac08 | |||
| c7bae75ed0 | |||
| 595cbc8a68 | |||
| ebd64e0f76 | |||
| 9ec2af86ac | |||
| 5f26cef580 | |||
| db0e5620b2 | |||
| 0e693b7f74 | |||
| c0a13b5f87 | |||
| 364b8ec0d4 | |||
| c86b583830 | |||
| 78b1b599a5 | |||
| e32d0772e9 | |||
| ef6651c8d2 | |||
| 5b6d5cdac2 | |||
| 83b8ce8869 | |||
| bd048daa86 | |||
| c36ad87658 | |||
| b7773d6257 | |||
| 6a9f9f36c0 | |||
| 936ee15e38 | |||
| 43e394ef7d | |||
| 7c18b3f7dd | |||
| a656240bfb | |||
| 4a74989a95 | |||
| 7c769c18f4 | |||
| 5e82010ace | |||
| dece83c3e8 | |||
| 944b24fe59 | |||
| 26d85bafd0 | |||
| 64a2073bc4 | |||
| 476acf7a6a | |||
| e4ebbb825d | |||
| 7960063e0e | |||
| 707db2ebc6 | |||
| 06dc71523e | |||
| 618ff9e488 | |||
| 76a8190fc6 | |||
| 4a0bce64a1 | |||
| 63e3f24f0b | |||
| d3190ecdec | |||
| 3ff1da10c6 | |||
| 9610c9477e | |||
| a22dcd87dc | |||
| 13b91dd423 | |||
| 75bf62e125 | |||
| 0e88e4293a | |||
| 2f25f76377 | |||
| 95abe98626 | |||
| 011c2698a4 | |||
| 088024f357 | |||
| 8cd4ecd63b | |||
| 0922a03a47 | |||
| 5b6df321b9 | |||
| 1fc835263d | |||
| f131de9df2 | |||
| 5a892af3d6 | |||
| ce939ee063 | |||
| d3d31d6c12 | |||
| bd316723f5 | |||
| 8b22e548be | |||
| 62366d95a7 | |||
| 78c541f2b8 | |||
| 4fe26326cc | |||
| 03ef999dac | |||
| 5d8a0f5e9a | |||
| 287fdec12e | |||
| ba1b9e1fbe | |||
| 696c12ec18 | |||
| 27db41c3f0 | |||
| e77f2b68f5 | |||
| 5e043fe17c | |||
| abc195aee6 | |||
| e381bc2256 | |||
| f2b841d735 | |||
| f7ff52dfdd | |||
| 4b0f9cd5b8 | |||
| 294fa322e2 | |||
| cbba936ed8 | |||
| e7874a2c25 | |||
| cd0110527c | |||
| 17535d4b7a | |||
| 9a907d87e5 | |||
| 9f40a9ea14 | |||
| aae3a6c62d | |||
| 600b6893e5 | |||
| 256e8e33ad | |||
| ee35b11341 | |||
| 5bfbcefffa | |||
| d7e0a84596 | |||
| b97f23701f | |||
| 25c2d5cd1e | |||
| 467bacc00a | |||
| 9bd17c401d | |||
| 2598c4953a | |||
| a8a889fb35 | |||
| f7dd646e57 | |||
| e1634f6abe | |||
| 73d308164d | |||
| 4fcee60ba6 | |||
| 62eb010998 | |||
| 4f993a906a | |||
| e03cbbe8aa | |||
| 5317230b08 | |||
| 46f3e56c09 | |||
| 0ac3cd02b0 | |||
| e5dffb5533 | |||
| 88d1b58f1f | |||
| 00756e6908 | |||
| 164182012f | |||
| 4d70be3404 | |||
| 0d1926f7d7 | |||
| 327a85e042 | |||
| b6ea9159d8 | |||
| 9c1f146c05 | |||
| aceb994cae | |||
| 163e666834 | |||
| dd9e059036 | |||
| 567d6ca181 | |||
| d427b5c4a4 | |||
| 93d7f8a5fc | |||
| 22286c7e02 | |||
| 26f0723641 | |||
| a4c31e096b | |||
| 9f48dd57a4 | |||
| 3116c230ae | |||
| 23f7c5a5eb | |||
| 5a5d7fd4e7 | |||
| ca7289b173 | |||
| eebb3a830b | |||
| dc6bb088a1 | |||
| a95aa6dd49 | |||
| ce1b1edcb8 | |||
| 335a4124ab | |||
| a6dab8f3aa | |||
| f5e7b907a9 | |||
| dda21d2570 | |||
| 2d7cf6ec2b | |||
| ef3c66e8f0 | |||
| d94bf67340 | |||
| 3a11682a37 | |||
| 2ba8278ab7 | |||
| 353e13d5be | |||
| ac84ad4bbf | |||
| 8c1a01d856 | |||
| 2fdd96e68c | |||
| e1e4e05237 | |||
| 3949ff1531 | |||
| 9ab64bcbdf | |||
| 9805582278 | |||
| 7c04a0653b | |||
| e59539fec8 | |||
| 30488c512d | |||
| 7b4b716fc6 | |||
| 74101edeca | |||
| 9db7180eb9 | |||
| c2f34c62f3 | |||
| 47dfd372fe | |||
| edabbec874 | |||
| 1736300784 | |||
| 98d3bf4410 | |||
| 7e69883dfc | |||
| 3542b897c8 | |||
| c03291e7f7 | |||
| 183579449c | |||
| 3e4015b686 | |||
| d006f8d932 | |||
| e5369090fa | |||
| 14ffe3545a | |||
| 3381673ae6 | |||
| 0b32df57f0 | |||
| d2ae0fa765 | |||
| ddb813576e | |||
| 88078f1d7e | |||
| 45b705ba85 | |||
| 9bfc107415 | |||
| 9909b3df73 | |||
| af349b3db1 | |||
| 6d95ea00f5 | |||
| 5a266b952f | |||
| 61cb3338e8 | |||
| 9ba97b7e29 | |||
| 37cda2a39a | |||
| 824758179b | |||
| d6070cc185 | |||
| 9059b2b32a | |||
| b84538e4cb | |||
| b6c4beaada | |||
| 1f47b10fa9 | |||
| 6443a5c442 | |||
| cba4660777 | |||
| 8a84ab4089 | |||
| dcb553fd16 | |||
| 220e9bb072 | |||
| dcca4e86e4 | |||
| 728b216dcc | |||
| a1647e9552 | |||
| 9171cb1129 | |||
| ead5da4ab3 | |||
| 9d41fcdc50 | |||
| e7e26db4aa | |||
| e500e88e40 | |||
| f898d642d0 | |||
| bc85dabf90 | |||
| b830a99a5f | |||
| 1c35a625e1 | |||
| dc387f6ffb | |||
| d72b199645 | |||
| 5ed787a8ca | |||
| c95f2af8ff | |||
| 992f5bcc0e | |||
| bd83d036ba | |||
| 04647c079e | |||
| d717ceb4cd | |||
| 77f141e223 | |||
| a64a7f198d | |||
| 8de60aaef4 | |||
| ef81dd1b3e | |||
| cd1e13c1e2 | |||
| 4c7ff89950 | |||
| 6873f2cc68 | |||
| cdaecc2afb | |||
| c3b1e8c370 | |||
| 89d94d6993 | |||
| b350781ab5 | |||
| af858a3f36 | |||
| 2b07f56673 | |||
| daae3715bf | |||
| 357319a775 | |||
| bab3f63227 | |||
| e9507d8884 | |||
| 73db689386 | |||
| 7219ded3e8 | |||
| 34c2fa22e5 | |||
| 83c14d3a8e | |||
| a8c7f77d87 | |||
| 1c44095b84 | |||
| b29f1c407c | |||
| 9d6f741092 | |||
| 17883e1529 | |||
| 2c14e5318a | |||
| f58e192001 | |||
| ae681e3ecd | |||
| 3a27c78f49 | |||
| c3fed8efa2 | |||
| 2e32377a0d | |||
| b211e3e410 | |||
| 1f27bfbeed | |||
| 658807b219 | |||
| 49557b4c74 | |||
| 20a764b3ee | |||
| 511716bfd5 | |||
| d1159313ac | |||
| 8a0a05dca2 | |||
| 5ad3c0002d | |||
| 346bf61166 | |||
| fb3a7c186b | |||
| 81915651bd | |||
| 00be838b76 | |||
| 49a73c90e4 | |||
| 918146d4a6 | |||
| 21fa91afd1 | |||
| 0c4689a81b | |||
| c608b9f63e | |||
| 7ac028421a | |||
| 3cea2af4e1 | |||
| 714352ec18 | |||
| e59f439101 | |||
| 7b05e4b396 | |||
| 0fb4ce0001 | |||
| 89256f1e80 | |||
| f69c10d3a0 | |||
| 88a37e4735 | |||
| be9ff8b788 | |||
| aa72204a06 | |||
| 6b91cc58a9 | |||
| 19d34286d5 | |||
| 6e2dbf03cc | |||
| 0e4f579899 | |||
| 8fd4ac741e | |||
| 2590b2e828 | |||
| e5f148e534 | |||
| d2ce185441 | |||
| bba46b5c7f | |||
| f741c15829 | |||
| 1366e7e231 | |||
| 86cd79dd45 | |||
| 0b6c8cd7a0 | |||
| d5ffc159c0 | |||
| ba8cfd2594 | |||
| 36a8bf9625 | |||
| 614c32bcba | |||
| 710c3a53d0 | |||
| deb218943c | |||
| 54c3bbac2c | |||
| b9579e2a2e | |||
| 56591f4118 | |||
| 8c7274edcc | |||
| 12b01f065c | |||
| 9ba8471002 | |||
| f2d7062bcb | |||
| b375f1a5e2 | |||
| 2e66aa42b6 | |||
| 7901beee1e | |||
| 187911320b | |||
| 3952716ef8 | |||
| 7e09947e62 | |||
| 2b101f0fd8 | |||
| 33eb24a3dc | |||
| 2e7dd44ae6 | |||
| 0b1451800c | |||
| 41d2ffcc24 | |||
| 1724296e59 | |||
| 0da5ee9d01 | |||
| c8213be2b6 | |||
| b7bfe89151 | |||
| dbd9f2973c | |||
| e01a27d7b7 | |||
| b5b8f2da9d | |||
| dfc28c15f8 | |||
| fc524cd2d4 | |||
| 366362d62b | |||
| 5fbb9e63e3 | |||
| f694af80eb | |||
| 78be1304ec | |||
| 720cb2a13a | |||
| 147cee9721 | |||
| 97ab76e9c8 | |||
| c9a7f095c4 | |||
| a9261a8052 | |||
| 18fde37b9b | |||
| 0035931734 | |||
| e0bef82b06 | |||
| 3aedf9e137 | |||
| b48407115e | |||
| 59150c1186 | |||
| 8b669f5c86 | |||
| 81313b6fa4 | |||
| ece6644522 | |||
| 8ffc83bb39 | |||
| b39e44e6ab | |||
| de243cdbd9 | |||
| e21e274c2a | |||
| db363be37b | |||
| d531626836 | |||
| 04fb0089b5 | |||
| 7746a984ec | |||
| af08d7113a | |||
| c51b689070 | |||
| 29e1ec799e | |||
| d9515fa8f0 | |||
| c00bb0be61 | |||
| 44db357b73 | |||
| 2508d9031d | |||
| 66bf1f82eb | |||
| 5e1357116d | |||
| fd82db0d75 | |||
| a7569deb26 | |||
| a5295db539 | |||
| bd15f790cc | |||
| 3fb3f2108a | |||
| 96d1e6b62d | |||
| a2009fa7ac | |||
| e38f68fa33 | |||
| 354daba672 | |||
| 17f4413afa | |||
| d68028caba | |||
| 124e3097ec | |||
| b65843828b | |||
| 7e26941ffc | |||
| 4533e3e1c4 | |||
| d5bc7b8889 | |||
| 8f41ed4c02 | |||
| 00cf2ed341 | |||
| 704231457f | |||
| 1150d4e4e6 | |||
| 5cb5dc2c32 | |||
| 75d6f4cb71 | |||
| 143325c033 | |||
| d466d4a3c2 | |||
| 578d3a5669 | |||
| e1e0b689d2 | |||
| 51e30a42b5 | |||
| 866aa4a041 | |||
| dc3ff364a4 | |||
| 6f561393f4 | |||
| 59e60960b0 | |||
| 6c4f8a4551 | |||
| b88648499e | |||
| 221f08aaf6 | |||
| 5afe4613c4 | |||
| 296aa6a6ae | |||
| 8bfa49807d | |||
| d942275920 | |||
| 8186b25575 | |||
| 9e15cf43e3 | |||
| 21c0c2ed60 | |||
| 930f960318 | |||
| e5f610a033 | |||
| ce69fbd600 | |||
| bee5627ec0 | |||
| e92fda612c | |||
| 3dba3682b3 | |||
| 582ea909ca | |||
| eecdcc4f83 | |||
| f07f3acbd8 | |||
| 179e4d3815 | |||
| 0547433c2f | |||
| 20f8d6a311 | |||
| 8a23bf7eec | |||
| 549dfeefc8 | |||
| d88635db67 | |||
| 236977940e | |||
| d4140437f1 | |||
| 8fcc78bb52 | |||
| 657bfdc35e | |||
| 4a894a1937 | |||
| f2d58d5b15 | |||
| bd4579ebbf | |||
| 2d2fd9040d | |||
| cea2dffdc3 | |||
| 97ab678691 | |||
| d972c36fa8 | |||
| 84ef94253c | |||
| b63f2fdfbc | |||
| 0092a67fc7 | |||
| 2a91a791be | |||
| 217d42cc9a | |||
| 41319562d8 | |||
| f7fde413e0 | |||
| 77aa09235e | |||
| 54dd012cfa | |||
| 2165322c02 | |||
| ae58948abd | |||
| 346d80e07e | |||
| cec0ac2ffe | |||
| 451ffd601c | |||
| de555b7524 | |||
| f9a53f508e | |||
| bd3ab20e1d | |||
| ae2ffd8dbf | |||
| b76ccb20b8 | |||
| 035efa9fa1 | |||
| 3af1b3e5f4 | |||
| 52d1e379e3 | |||
| b4d924b132 | |||
| 5d485e01b5 | |||
| be38af2dad | |||
| 5d09111528 | |||
| 029ef2e2d3 | |||
| 513c33330d | |||
| 8db506a5a6 | |||
| d26244fdc9 | |||
| bddebcc8fa | |||
| b4e219a5e2 | |||
| 0b52c4ab40 | |||
| 6c91aad0e1 | |||
| 576e8a8f46 | |||
| 466742207e | |||
| e86bcec37c | |||
| 1e564613c2 | |||
| 69477c67bb | |||
| 94c542f95f | |||
| d030cca19e | |||
| 1637765c6f | |||
| fc538e1dde | |||
| e63cb5bff7 | |||
| c0bae1ee31 | |||
| 10423ae915 | |||
| c68ef8acd0 | |||
| 1a8d817cb2 | |||
| 3807604c6f | |||
| c4f54f77ed | |||
| 72dda418ea | |||
| de681dd967 | |||
| 44e64cf9c6 | |||
| 0e4c392b48 | |||
| f0a3923a4f | |||
| f106ec4423 | |||
| 15c32d5711 | |||
| c3454e352d | |||
| ba58895d3a | |||
| f47c00bed0 | |||
| 7b2cc8da0a | |||
| e058d09683 | |||
| 4511b5e2c6 | |||
| c2cb428413 | |||
| 53f9e6dd75 | |||
| 1248bb0b3b | |||
| 0ce0c51ff6 | |||
| 6e58f74b65 | |||
| 2ef0769730 | |||
| 95b7cf7ced | |||
| 0ace432e87 | |||
| f5bca70c60 | |||
| e371defa8d | |||
| 665fb1ab0f | |||
| 7ae19bf5cb | |||
| 8dabcb31c2 | |||
| 94d2f3d6ca | |||
| 61a1e832a0 | |||
| ab13d95898 | |||
| d74d99bcc9 |
|
|
@ -9,7 +9,7 @@
|
|||
"name": "storebound",
|
||||
"source": ".",
|
||||
"description": "Take a mobile app or game from nothing to Submit for review on both stores: skills for every store step and questionnaire plus the storebound CLI and MCP server.",
|
||||
"version": "0.5.0",
|
||||
"version": "0.8.78",
|
||||
"category": "development",
|
||||
"tags": [
|
||||
"mobile",
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "storebound",
|
||||
"version": "0.5.0",
|
||||
"version": "0.8.78",
|
||||
"description": "Take a mobile app or game from nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products and subscriptions with regional prices, every questionnaire (Data safety, App access and demo accounts, account deletion, IARC, target audience, ads, App Privacy, age rating, export compliance), privacy, icons, screenshots and previews, validate, TestFlight, release management, and after launch: crash vitals, review replies, price sheets, store analytics, Product Page Optimization. Agent Skills plus a Bun CLI and MCP server (storebound); you press Submit. CRTkafa's own toolchain, open-sourced.",
|
||||
"author": {
|
||||
"name": "CRTkafa"
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "storebound",
|
||||
"version": "0.5.0",
|
||||
"version": "0.8.78",
|
||||
"description": "Take a mobile app or game from nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products and subscriptions with regional prices, every questionnaire (Data safety, App access and demo accounts, account deletion, IARC, target audience, ads, App Privacy, age rating, export compliance), privacy, icons, screenshots and previews, validate, TestFlight, release management, and after launch: crash vitals, review replies, price sheets, store analytics, Product Page Optimization. Agent Skills plus a Bun CLI and MCP server (storebound); you press Submit. CRTkafa's own toolchain, open-sourced.",
|
||||
"author": {
|
||||
"name": "CRTkafa"
|
||||
|
|
|
|||
|
|
@ -7,20 +7,62 @@ alwaysApply: false
|
|||
|
||||
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
||||
|
||||
1. **The owner decides public and irreversible steps.** Submitting for review (App Review or Beta App Review),
|
||||
releasing a version, resuming or completing a rollout, canceling a submission, deleting products or listings,
|
||||
accepting agreements, sending review replies, inviting or removing testers, changing prices, starting or stopping
|
||||
a store experiment: explain what will happen and let the owner do it (or run the command only after a clear yes in
|
||||
chat). storebound's MCP server does not offer these at all.
|
||||
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
||||
for real only after the owner agrees.
|
||||
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
||||
what is missing and in which order to fix it.
|
||||
4. **Credentials only from the environment or `.storebound/`** in the project (gitignored). Never ask for keys,
|
||||
## First rule: do it, don't ask
|
||||
|
||||
storebound plus you, the AI agent, do the work. The owner is not your pair of hands.
|
||||
|
||||
1. **You do everything yourself:** API calls, uploads, builds, template and CSV downloads and exports, every console
|
||||
navigation (open, Get Started, Edit, Next, Continue, Save draft), console forms, and the verification afterwards.
|
||||
Never tell the owner "run this yourself" or "click X yourself" for any of these.
|
||||
2. **The owner keeps only the final public or irreversible buttons:** Submit for review (App Review or Beta App
|
||||
Review), releasing a version or completing / resuming a production rollout, App Privacy Publish, accepting legal
|
||||
agreements; plus deleting store data, changing live prices, sending review replies and inviting or removing
|
||||
testers. (Also the owner's: canceling a submission, starting or stopping a store experiment, a console form's final
|
||||
Submit / Create that a console plan lists in `buttons.final`, signing in and granting account permissions.) For
|
||||
these you prepare everything, show the dry run, and the owner presses one button or says yes.
|
||||
**Updates are agent steps:** a new version of an app that is already on the store (Play: the production track holds
|
||||
a published release; App Store: a version of the platform is or was on sale) is yours end to end, no owner gate
|
||||
per update: `storebound play release <aab> --production completed --yes`, `storebound play upload --track
|
||||
production --yes`, `storebound apple submit --build <n> --yes`, `storebound apple release --manual-release --yes`
|
||||
(docs/bypass.md). Only the **first-ever release** of an app stays the owner's (exit 3 `OWNER_STEP`: after the
|
||||
owner's yes re-run with `--first-release`), plus removal from sale, live price changes and anything that costs money.
|
||||
**Bypass mode** (`storebound settings bypass status`): when the owner turned it on, you run these owner steps too:
|
||||
MCP `owner_step` (dry run first, then `dry_run: false`), `storebound api ... --yes --confirm <operationId>`, and
|
||||
console plans' `buttons.final`. Say in one line what you pressed; every action is logged to
|
||||
`.storebound/owner-actions.log`. Legal agreements, passwords and 2FA stay with the owner if your own rules say so.
|
||||
3. **Ask the owner only for facts that no code, config or doc can prove:** compliance answers such as Data safety,
|
||||
App Privacy, age rating, export compliance, partial data deletion. Collect ALL of them in ONE batch at the start
|
||||
(`storebound check` and `storebound validate` list them), never one at a time during the run. Reuse answers that
|
||||
are already in the config.
|
||||
4. **Default loop:** plan, then you drive (the API first, your browser tool for consoles without an API), then verify
|
||||
(read it back), then continue. No round trip to the owner in between.
|
||||
5. **Catch rejections offline.** Before a write, `storebound check` and `--dry` must catch what the store would refuse
|
||||
(live-shape fixtures, id and pair checks). A failure belongs in the dry run, not in a 400 at write time; when a
|
||||
store refuses something the dry run passed, fix the check (pitfalls), not just the data.
|
||||
|
||||
Every hour of "please click this" is an hour the owner did not want to spend. If you catch yourself writing "you
|
||||
need to ...", do it instead, unless it is one of the owner steps in point 2.
|
||||
|
||||
## The other rules
|
||||
|
||||
**Read `skills/store-pitfalls/SKILL.md` before any store task.** It lists the mistakes already made in real releases
|
||||
(store lists that lag after a create, dry runs without a plan, taken App Store names, byte limits, ...) and what to do.
|
||||
|
||||
1. **The owner presses only the owner steps** (point 2 of the first rule). Prepare them completely, say what will
|
||||
happen, and let the owner press the button, or run the command only after a clear yes in chat. storebound's MCP
|
||||
server does not offer these at all. Everything else you run yourself.
|
||||
2. **Dry run first, then run it yourself.** Every write command has `--dry` (MCP: `dry_run`, default true). Run the
|
||||
dry run, check and show it (the rows that change, not just a count), then run the real command yourself (`--yes`
|
||||
where it asks for a confirmation) and read the result back. Wait for the owner's yes only before an owner step.
|
||||
3. **Read before you write.** `storebound scan` (offline: rejection risks in the project itself), `storebound check`
|
||||
(offline) and `storebound validate` (read-only, both stores) tell you what is missing and in which order to fix it.
|
||||
4. **Credentials only from the environment, `.storebound/`** in the project (gitignored) **or a credential profile**
|
||||
(`~/.storebound/credentials/<profile>.json`, named by `--account <profile>` or a workspace). Never ask for keys,
|
||||
passwords or tokens in chat, never print them, never write them into the config, docs or commits. The same goes
|
||||
for the App Review demo account (`reviewDemoAccount` in `.storebound/credentials.json`): the owner puts it there.
|
||||
5. **Never answer a compliance question you cannot know.** Export compliance, Data safety, App Privacy, age rating,
|
||||
target audience: ask the owner when the code does not prove the answer. A wrong "no" is worse than a slow "ask".
|
||||
target audience: ask the owner when the code does not prove the answer, all such questions in one batch at the
|
||||
start (first rule, point 3), and write the answers into the config. A wrong "no" is worse than a slow "ask".
|
||||
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
||||
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
||||
you report the progress lines, not guesses.
|
||||
|
|
@ -29,37 +71,62 @@ These rules apply to every AI tool that uses storebound (skills, MCP server or t
|
|||
9. **Personal data stays local.** Tester lists, review reply drafts, health reports and analytics snapshots live in
|
||||
`.storebound/` (gitignored). Never put tester emails, reviewer names or crash logs into issues, docs or commits,
|
||||
and never ask for tester emails in chat (storebound masks them in its output).
|
||||
10. **Console forms without an API: drive them yourself, agent-first.** `storebound console plan <form> --json` (MCP
|
||||
`console_plan`) gives the start URL, steps, the answer sheet, the buttons you must never press and the verified UI
|
||||
facts. Drive the page with your own browser tool, adapt to what it shows, run long flows as an in-page async loop
|
||||
that writes `window.__log` (one evaluate call times out around 45 s), stop only before the final button (Publish,
|
||||
Submit, Create, a final Save) and tell the owner exactly what to press, then `storebound console verify <form>`.
|
||||
Never sign in, accept an agreement or grant a permission (a service account's app access) for the owner.
|
||||
`storebound console fill` is the optional scripted fast path; it never blocks you.
|
||||
11. **Console pages: always the absolute deep link.** When you send the owner to a console page, give the absolute
|
||||
deep link (storebound prints it; `storebound console plan` has start URLs), never just "go to App Store Connect"
|
||||
or "App Store Connect > App Information" alone.
|
||||
|
||||
## Tools
|
||||
|
||||
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||
- CLI: `storebound <command>` (`storebound help`; outside the plugin: `npx storebound` on Node 20+ or `bunx storebound` on Bun); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||
- MCP: `storebound mcp` (stdio). MCP 2026-07-28 + 2025-11-25. Write tools default to `dry_run: true`; submit / release / cancel / delete / send are not exposed.
|
||||
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||
- Readiness: `storebound scan` (offline rejection risks in the project files), `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||
- Every endpoint: `storebound api apple|play <operationId>` (skill store-api). GETs run; writes are dry unless the owner adds `--yes` in a terminal; MCP has the read-only `api_get`.
|
||||
|
||||
## Skills
|
||||
|
||||
- `skills/account-deletion/SKILL.md`: Make account deletion pass App Store and Google Play review for an app with sign-up or sign-in
|
||||
- `skills/adhoc-distribution/SKILL.md`: Get a test build of a mobile app or game onto specific devices without a store review
|
||||
- `skills/ads-levelplay-checks/SKILL.md`: Renamed to ads-mediation-checks (AdMob, AppLovin MAX and Unity LevelPlay / ironSource). Kept so existing installs and links keep working. Use ads-mediation-checks for any ad mediation, app-ads.txt, SKAdNetwork or "no fill" question
|
||||
- `skills/ads-mediation-checks/SKILL.md`: Diagnose and verify ad mediation in a mobile app or game before and after store release
|
||||
- `skills/app-icons/SKILL.md`: Generate every icon a mobile app or game needs from one artwork
|
||||
- `skills/app-previews/SKILL.md`: Make App Store app preview videos and a Google Play promo video for a mobile app or game from real footage (gameplay or app flows)
|
||||
- `skills/app-store-promotion/SKILL.md`: App Store promotion tools for a mobile app or game through the App Store Connect API
|
||||
- `skills/apple-ads/SKILL.md`: Read Apple Ads (formerly Apple Search Ads) results for a mobile app or game and make small, owner-approved bid, daily budget and pause changes
|
||||
- `skills/appstore-first-release/SKILL.md`: Step-by-step first (and later) App Store release of a mobile app or game
|
||||
- `skills/aso-basics/SKILL.md`: App store optimization basics for a mobile app's or game's text
|
||||
- `skills/build-and-sign/SKILL.md`: Sign, build and upload a mobile app or game from the terminal
|
||||
- `skills/console-autofill/SKILL.md`: Fill App Store Connect and Google Play Console forms that have no API (New App, App Privacy, Play Create app, IARC content rating, every Play App content card, Play Store settings category, first production release countries and send-for-review). Agent-first by default
|
||||
- `skills/export-compliance/SKILL.md`: Answer App Store export compliance (encryption) for a mobile app or game correctly
|
||||
- `skills/game-services/SKILL.md`: Set up Game Center (App Store) and Play Games Services (Google Play) for a mobile game from one config section
|
||||
- `skills/listing-localization/SKILL.md`: Translate the store listing of a mobile app or game into more languages
|
||||
- `skills/migrate-from-fastlane/SKILL.md`: Move a mobile app or game from fastlane (deliver, supply, snapshot / screengrab, Appfile, Deliverfile) to storebound with `storebound import fastlane`
|
||||
- `skills/play-first-release/SKILL.md`: Step-by-step first (and later) Google Play release of a mobile app or game
|
||||
- `skills/portfolio-originality/SKILL.md`: Originality gate for studios and developers that ship many similar mobile apps or games (templates, white-label apps, reskins)
|
||||
- `skills/ppp-pricing/SKILL.md`: Propose purchasing power parity (PPP) prices for a mobile app's or game's in-app products in every App Store territory and Google Play region with `storebound prices ppp`
|
||||
- `skills/privacy-manifest/SKILL.md`: Add and check Apple privacy manifests (PrivacyInfo.xcprivacy) for an iOS app or game
|
||||
- `skills/privacy-policy/SKILL.md`: Write and host one studio-wide privacy policy page for all of a developer's mobile apps and games
|
||||
- `skills/release-flows/SKILL.md`: Repo-local workflows for a mobile app or game
|
||||
- `skills/release-management/SKILL.md`: Ship updates safely after the first release
|
||||
- `skills/revenuecat-sync/SKILL.md`: Optional adapter that keeps a RevenueCat project's catalog in step with the storebound config
|
||||
- `skills/review-access/SKILL.md`: Give App Store and Google Play reviewers working access to an app behind a sign-in
|
||||
- `skills/review-rejections/SKILL.md`: Triage and answer an App Store or Google Play rejection, policy warning or strike for a mobile app or game
|
||||
- `skills/review-replies/SKILL.md`: Reply to App Store and Google Play reviews of a mobile app or game the safe way
|
||||
- `skills/store-analytics/SKILL.md`: Take store analytics snapshots for a mobile app or game (App Store impressions, product page views, downloads and conversion through the Analytics Reports API; Google Play store listing visitors, acquisitions and installs from the Play reports bucket) and compare them with listing, screenshot and experiment changes from git
|
||||
- `skills/store-analytics/SKILL.md`: Take store analytics snapshots for a mobile app or game (App Store impressions, product page views, downloads and conversion through the Analytics Reports API; Google Play store listing visitors, acquisitions and installs from the Play reports bucket) and compare them with listing, screenshot and experiment changes from git; download App Store sales / finance reports and Play earnings / sales reports with a summary per product and currency
|
||||
- `skills/store-api/SKILL.md`: Call any App Store Connect API or Google Play Developer API operation that storebound's commands do not wrap, safely
|
||||
- `skills/store-declarations/SKILL.md`: Answer the store compliance forms for a mobile app or game
|
||||
- `skills/store-health/SKILL.md`: Watch a released mobile app's or game's crash and ANR health on both stores
|
||||
- `skills/store-iap-setup/SKILL.md`: Create and price in-app purchases (consumables, non-consumables like "remove ads" or a Pro unlock, non-renewing passes, coin/gem packs, starter packs) on Google Play and App Store Connect from one product list
|
||||
- `skills/store-pitfalls/SKILL.md`: Known pitfalls with App Store Connect, Google Play and storebound itself, learned from real releases, and what to do about each
|
||||
- `skills/store-preflight/SKILL.md`: Run and read the storebound readiness checks before submitting a mobile app or game
|
||||
- `skills/store-screenshots/SKILL.md`: Produce store screenshots and the Play feature graphic for a mobile app or game in every required size and many languages
|
||||
- `skills/store-subscriptions/SKILL.md`: Set up auto-renewable subscriptions on the App Store and Google Play from one config
|
||||
- `skills/testflight/SKILL.md`: Run TestFlight for a mobile app or game through the App Store Connect API
|
||||
- `skills/web-presence/SKILL.md`: Set up the web side of a mobile app or game
|
||||
- `skills/whats-new/SKILL.md`: Write user-facing release notes ("What's new") for a mobile app or game update from the git log since the last tag
|
||||
|
|
|
|||
31
.forgejo/actions/ci-run/action.yml
Normal file
|
|
@ -0,0 +1,31 @@
|
|||
# `bun run ci` after .forgejo/actions/linux-setup: the target / timings caches, bun install, Node 20 (the npm bundle's oldest supported Node) and the full CI. Shared by ci.yml and release.yml.
|
||||
name: ci-run
|
||||
description: storebound's full CI (bun run ci) on the Linux runner
|
||||
runs:
|
||||
using: composite
|
||||
steps:
|
||||
- uses: actions/cache@v4
|
||||
with:
|
||||
path: apps/desktop/src-tauri/target
|
||||
key: ci-target-${{ runner.os }}-${{ hashFiles('apps/desktop/src-tauri/Cargo.lock') }}
|
||||
restore-keys: ci-target-${{ runner.os }}-
|
||||
# recorded test durations (shard balance) and tsc's incremental build info
|
||||
- uses: actions/cache@v4
|
||||
with:
|
||||
path: node_modules/.cache/storebound-ci
|
||||
key: ci-timings-${{ runner.os }}-${{ github.sha }}
|
||||
restore-keys: ci-timings-${{ runner.os }}-
|
||||
- name: Install
|
||||
shell: bash
|
||||
run: |
|
||||
bun --version && cargo --version
|
||||
bun install --frozen-lockfile
|
||||
# the npm bundle runs on Node 20+: tools/ci.ts smoke-tests dist/storebound.mjs with the oldest supported Node
|
||||
- uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version: '20'
|
||||
# no browser tests in CI (tests/browser/ runs only with `bun run test:browser`); the changes of this push (against
|
||||
# its parent; the checkout has fetch-depth 2) decide the Rust steps, as on a laptop against origin/main
|
||||
- name: bun run ci
|
||||
shell: bash
|
||||
run: STOREBOUND_CI_BASE=HEAD~1 bun run ci
|
||||
43
.forgejo/actions/linux-setup/action.yml
Normal file
|
|
@ -0,0 +1,43 @@
|
|||
# Shared setup of the Linux jobs (ci.yml; release.yml's ci and linux jobs) on the VDS runner (label ubuntu-22.04, the
|
||||
# catthehacker act image): Tauri's system packages plus `packages`, the Bun / Cargo caches, Bun and Rust on PATH.
|
||||
name: linux-setup
|
||||
description: System packages, caches, Bun and Rust for storebound's Linux jobs
|
||||
inputs:
|
||||
packages:
|
||||
description: Extra apt packages
|
||||
default: ''
|
||||
cache-key:
|
||||
description: Cache key prefix (separate caches for CI and the installer build)
|
||||
default: ci
|
||||
rust-components:
|
||||
description: Extra rustup components (for example clippy)
|
||||
default: ''
|
||||
runs:
|
||||
using: composite
|
||||
steps:
|
||||
- name: System packages
|
||||
shell: bash
|
||||
run: |
|
||||
sudo apt-get update -qq
|
||||
sudo apt-get install -y -qq --no-install-recommends libwebkit2gtk-4.1-dev libgtk-3-dev \
|
||||
libayatana-appindicator3-dev librsvg2-dev libsoup-3.0-dev libjavascriptcoregtk-4.1-dev libssl-dev libxdo-dev \
|
||||
build-essential curl unzip pkg-config ${{ inputs.packages }} >/dev/null
|
||||
- uses: actions/cache@v4
|
||||
with:
|
||||
path: |
|
||||
~/.bun/install/cache
|
||||
~/.cache/tauri
|
||||
~/.cargo/registry/index
|
||||
~/.cargo/registry/cache
|
||||
~/.cargo/git/db
|
||||
key: ${{ inputs.cache-key }}-${{ runner.os }}-${{ hashFiles('bun.lock', 'apps/desktop/src-tauri/Cargo.lock') }}
|
||||
restore-keys: ${{ inputs.cache-key }}-${{ runner.os }}-
|
||||
- name: Bun and Rust
|
||||
shell: bash
|
||||
run: |
|
||||
P="${FORGEJO_PATH:-$GITHUB_PATH}"
|
||||
bash tools/ci-install-bun.sh
|
||||
echo "$HOME/.bun/bin" >> "$P"
|
||||
command -v rustup || curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal
|
||||
echo "$HOME/.cargo/bin" >> "$P"
|
||||
for c in ${{ inputs.rust-components }}; do "$HOME/.cargo/bin/rustup" component add "$c"; done
|
||||
110
.forgejo/workflows/acceptance.yml
Normal file
|
|
@ -0,0 +1,110 @@
|
|||
# The release acceptance matrix on demand (the same jobs as release.yml's acceptance + acceptance-report, which gate
|
||||
# every release): every user-facing command from the packed npm tarball on Linux and Windows x Node 20 / Node 22 / Bun,
|
||||
# then the markdown matrix (artifact storebound-acceptance). Run it from Actions > acceptance > Run workflow, or with
|
||||
# the API (POST /repos/{owner}/{repo}/actions/workflows/acceptance.yml/dispatches). macOS: tools/acceptance.ts on the Mac.
|
||||
name: acceptance
|
||||
|
||||
on:
|
||||
workflow_dispatch:
|
||||
|
||||
env:
|
||||
BUN_VERSION: '1.4.0'
|
||||
|
||||
jobs:
|
||||
acceptance:
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
include:
|
||||
- { os: ubuntu-22.04, platform: Linux, runtime: node, node: '20', name: node20 }
|
||||
- { os: ubuntu-22.04, platform: Linux, runtime: node, node: '22', name: node22 }
|
||||
- { os: ubuntu-22.04, platform: Linux, runtime: bun, node: '22', name: bun }
|
||||
- { os: windows, platform: Windows, runtime: node, node: '20', name: node20 }
|
||||
- { os: windows, platform: Windows, runtime: node, node: '22', name: node22 }
|
||||
- { os: windows, platform: Windows, runtime: bun, node: '22', name: bun }
|
||||
runs-on: ${{ matrix.os }}
|
||||
timeout-minutes: 45
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version: ${{ matrix.node }}
|
||||
- name: Bun (Linux)
|
||||
if: ${{ matrix.platform == 'Linux' }}
|
||||
shell: bash
|
||||
run: |
|
||||
bash tools/ci-install-bun.sh
|
||||
echo "$HOME/.bun/bin" >> "${FORGEJO_PATH:-$GITHUB_PATH}"
|
||||
- name: Acceptance matrix (Linux)
|
||||
if: ${{ matrix.platform == 'Linux' }}
|
||||
shell: bash
|
||||
run: |
|
||||
node --version && bun --version
|
||||
bun install --frozen-lockfile
|
||||
bun tools/acceptance.ts run --runtime ${{ matrix.runtime }} --platform Linux --jobs 4 --out acceptance/Linux-${{ matrix.name }}.json
|
||||
- name: Acceptance matrix (Windows)
|
||||
if: ${{ matrix.platform == 'Windows' }}
|
||||
shell: pwsh
|
||||
run: |
|
||||
node --version; bun --version
|
||||
bun install --frozen-lockfile
|
||||
if ($LASTEXITCODE -ne 0) { throw "bun install failed" }
|
||||
bun tools/acceptance.ts run --runtime ${{ matrix.runtime }} --platform Windows --jobs 3 --out acceptance/Windows-${{ matrix.name }}.json
|
||||
if ($LASTEXITCODE -ne 0) { throw "acceptance matrix: red cells" }
|
||||
- uses: actions/upload-artifact@v3
|
||||
if: ${{ always() }}
|
||||
with:
|
||||
name: acceptance-${{ matrix.platform }}-${{ matrix.name }}
|
||||
path: acceptance/
|
||||
retention-days: 30
|
||||
|
||||
acceptance-report:
|
||||
needs: [acceptance]
|
||||
if: ${{ always() }}
|
||||
runs-on: ubuntu-22.04
|
||||
timeout-minutes: 10
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/download-artifact@v3
|
||||
continue-on-error: true
|
||||
with:
|
||||
name: acceptance-Linux-node20
|
||||
path: acceptance-runs/Linux-node20
|
||||
- uses: actions/download-artifact@v3
|
||||
continue-on-error: true
|
||||
with:
|
||||
name: acceptance-Linux-node22
|
||||
path: acceptance-runs/Linux-node22
|
||||
- uses: actions/download-artifact@v3
|
||||
continue-on-error: true
|
||||
with:
|
||||
name: acceptance-Linux-bun
|
||||
path: acceptance-runs/Linux-bun
|
||||
- uses: actions/download-artifact@v3
|
||||
continue-on-error: true
|
||||
with:
|
||||
name: acceptance-Windows-node20
|
||||
path: acceptance-runs/Windows-node20
|
||||
- uses: actions/download-artifact@v3
|
||||
continue-on-error: true
|
||||
with:
|
||||
name: acceptance-Windows-node22
|
||||
path: acceptance-runs/Windows-node22
|
||||
- uses: actions/download-artifact@v3
|
||||
continue-on-error: true
|
||||
with:
|
||||
name: acceptance-Windows-bun
|
||||
path: acceptance-runs/Windows-bun
|
||||
- name: Matrix (markdown), red cells fail the job
|
||||
run: |
|
||||
bash tools/ci-install-bun.sh
|
||||
export PATH="$HOME/.bun/bin:$PATH"
|
||||
V=$(bun tools/desktop-version.ts --print)
|
||||
mkdir -p out
|
||||
bun tools/acceptance.ts report acceptance-runs docs/acceptance --md "out/storebound_${V}_acceptance.md" --expect 9 --strict
|
||||
- uses: actions/upload-artifact@v3
|
||||
if: ${{ always() }}
|
||||
with:
|
||||
name: storebound-acceptance
|
||||
path: out/
|
||||
retention-days: 30
|
||||
428
.forgejo/workflows/ci.yml
Normal file
|
|
@ -0,0 +1,428 @@
|
|||
# Every push to main is a release candidate (docs/desktop-release.md, "Release candidates"). In parallel:
|
||||
# ci bun run ci (adapters, desktop version, tests, typecheck, desktop i18n / typecheck / build, the boot check
|
||||
# in headless Chromium, desktop Rust tests and clippy, scrub); tools/ci.ts runs it as a task graph with
|
||||
# parallel test shards on the one Linux runner; no browser test runs here (tests/browser/, `bun run
|
||||
# test:browser` by hand). The Rust steps run when the push changed a Rust input (STOREBOUND_CI_BASE).
|
||||
# acceptance the release acceptance matrix (tools/acceptance.ts): every user-facing command from the packed npm
|
||||
# tarball with real piped stdin, Linux and Windows x Node 20 / Node 22 / Bun.
|
||||
# linux AppImage + deb (path-free build), self-tests, both started under Xvfb, privacy scan.
|
||||
# windows NSIS installer, silent per-user install, self-test, uninstall, the Node prompt smoke, privacy scan.
|
||||
# record when all are green (the installers already scanned with the private terms): the draft release rc-<sha> with the installers, the acceptance runs and matrix and
|
||||
# green.json (tools/release-candidate.ts record). A v* tag on this commit only promotes it (release.yml).
|
||||
# gate decides first: a commit that differs from its green parent only in version copies + CHANGELOG (a release's
|
||||
# version bump, proven file by file: tools/release-candidate.ts gate) reuses the parent's ci and acceptance results
|
||||
# and builds only the installers, whose embedded version changed.
|
||||
# Pull requests run ci + acceptance (no installers, no record). rehearsal/* branches are release rehearsals
|
||||
# (tools/release.ts --rehearsal). site/ is still published by Jenkins.
|
||||
name: ci
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main, 'rehearsal/**']
|
||||
pull_request:
|
||||
branches: [main]
|
||||
workflow_dispatch:
|
||||
|
||||
env:
|
||||
BUN_VERSION: '1.4.0'
|
||||
CARGO_TERM_COLOR: never
|
||||
CARGO_INCREMENTAL: '0'
|
||||
|
||||
jobs:
|
||||
gate:
|
||||
runs-on: ubuntu-22.04
|
||||
# the self-hosted runners only run code from this repo: pull requests from forks are skipped
|
||||
if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
|
||||
timeout-minutes: 45
|
||||
outputs:
|
||||
reuse: ${{ steps.gate.outputs.reuse }}
|
||||
from: ${{ steps.gate.outputs.from }}
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
with:
|
||||
fetch-depth: 2
|
||||
- name: Version-only commit of a green parent?
|
||||
id: gate
|
||||
env:
|
||||
FORGEJO_TOKEN: ${{ secrets.RELEASE_TOKEN }}
|
||||
FORGEJO_URL: ${{ github.server_url }}
|
||||
FORGEJO_ORIGIN: ${{ secrets.FORGEJO_ORIGIN }}
|
||||
EVENT: ${{ github.event_name }}
|
||||
SHA: ${{ github.sha }}
|
||||
run: |
|
||||
# tests never gate a release (the owner's decision 2026-10-16): no waiting on the parent's run, which the
|
||||
# release's own bump push cancels; every commit builds its installers and runs the tests in the background
|
||||
echo "reuse=false" >> "$GITHUB_OUTPUT"; echo "from=" >> "$GITHUB_OUTPUT"; echo "tests run in the background; installers build for this commit"
|
||||
|
||||
# background tests (the owner's decision 2026-10-16): they run on every push and report, but the record job (the
|
||||
# release candidate) never waits for them; `bun tools/release.ts` and `bun tools/ci-status.ts` print a red result
|
||||
ci:
|
||||
needs: gate
|
||||
if: github.event_name != 'pull_request' || true
|
||||
# runner label: ubuntu-22.04:docker://ghcr.io/catthehacker/ubuntu:act-22.04
|
||||
runs-on: ubuntu-22.04
|
||||
timeout-minutes: 60
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
with:
|
||||
fetch-depth: 2
|
||||
- uses: ./.forgejo/actions/linux-setup
|
||||
with:
|
||||
cache-key: ci
|
||||
rust-components: clippy
|
||||
- uses: ./.forgejo/actions/ci-run
|
||||
|
||||
# The release acceptance matrix (tools/acceptance.ts, docs/acceptance.md): every user-facing command from the packed
|
||||
# npm tarball, in fresh temp folders with piped stdin and the fake stores, on Linux and Windows x Node 20 / Node 22
|
||||
# (npx --package=<tgz>) / Bun (bun x). One red cell and the commit is no candidate. macOS runs on the owner's Mac
|
||||
# (tools/release.ts, cached per CLI key).
|
||||
# after the installers: the one Windows runner builds the release installer first, the background tests wait
|
||||
# (0.8.13's Windows installer queued behind six acceptance jobs)
|
||||
acceptance:
|
||||
needs: [gate, linux, windows]
|
||||
if: github.event_name != 'pull_request' || true
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
include:
|
||||
- { os: ubuntu-22.04, platform: Linux, runtime: node, node: '20', name: node20 }
|
||||
- { os: ubuntu-22.04, platform: Linux, runtime: node, node: '22', name: node22 }
|
||||
- { os: ubuntu-22.04, platform: Linux, runtime: bun, node: '22', name: bun }
|
||||
- { os: windows, platform: Windows, runtime: node, node: '20', name: node20 }
|
||||
- { os: windows, platform: Windows, runtime: node, node: '22', name: node22 }
|
||||
- { os: windows, platform: Windows, runtime: bun, node: '22', name: bun }
|
||||
runs-on: ${{ matrix.os }}
|
||||
timeout-minutes: 45
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version: ${{ matrix.node }}
|
||||
- name: Bun (Linux)
|
||||
if: ${{ matrix.platform == 'Linux' }}
|
||||
shell: bash
|
||||
run: |
|
||||
bash tools/ci-install-bun.sh
|
||||
echo "$HOME/.bun/bin" >> "${FORGEJO_PATH:-$GITHUB_PATH}"
|
||||
- name: Acceptance matrix (Linux)
|
||||
if: ${{ matrix.platform == 'Linux' }}
|
||||
shell: bash
|
||||
run: |
|
||||
node --version && bun --version
|
||||
# npm pack runs prepack, which builds the package's declarations with the pinned TypeScript
|
||||
bun install --frozen-lockfile
|
||||
bun tools/acceptance.ts run --runtime ${{ matrix.runtime }} --platform Linux --jobs 4 --out acceptance/Linux-${{ matrix.name }}.json
|
||||
- name: Acceptance matrix (Windows)
|
||||
if: ${{ matrix.platform == 'Windows' }}
|
||||
shell: pwsh
|
||||
run: |
|
||||
node --version; bun --version
|
||||
# npm pack runs prepack, which builds the package's declarations with the pinned TypeScript
|
||||
bun install --frozen-lockfile
|
||||
if ($LASTEXITCODE -ne 0) { throw "bun install failed" }
|
||||
bun tools/acceptance.ts run --runtime ${{ matrix.runtime }} --platform Windows --jobs 3 --out acceptance/Windows-${{ matrix.name }}.json
|
||||
if ($LASTEXITCODE -ne 0) { throw "acceptance matrix: red cells" }
|
||||
- uses: actions/upload-artifact@v3
|
||||
if: ${{ always() }}
|
||||
with:
|
||||
name: acceptance-${{ matrix.platform }}-${{ matrix.name }}
|
||||
path: acceptance/
|
||||
retention-days: 14
|
||||
|
||||
linux:
|
||||
needs: gate
|
||||
if: github.event_name != 'pull_request'
|
||||
# runner label: ubuntu-22.04:docker://ghcr.io/catthehacker/ubuntu:act-22.04 (glibc 2.35: the AppImage and the
|
||||
# deb then run on Ubuntu 22.04 and newer, Debian 12)
|
||||
runs-on: ubuntu-22.04
|
||||
timeout-minutes: 90
|
||||
env:
|
||||
# the path-free build keeps the target folder outside every home folder
|
||||
CARGO_TARGET_DIR: /tmp/storebound-target
|
||||
# linuxdeploy (AppImage) runs without FUSE inside the container
|
||||
APPIMAGE_EXTRACT_AND_RUN: '1'
|
||||
# linuxdeploy must not strip: the storebound sidecar is a `bun build --compile` executable whose JS payload strip
|
||||
# removes (it then starts as plain bun). The Rust binary is already stripped by Cargo (profile.release strip).
|
||||
NO_STRIP: '1'
|
||||
# WebKitGTK's DMABUF renderer leaves the window blank on some GPU / VM setups; the app sets this itself at
|
||||
# start (src-tauri/src/lib.rs linux_webkit_env) unless the user did; set here too for anything run in CI
|
||||
WEBKIT_DISABLE_DMABUF_RENDERER: '1'
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: ./.forgejo/actions/linux-setup
|
||||
with:
|
||||
cache-key: desktop
|
||||
packages: patchelf file squashfs-tools p7zip-full xz-utils
|
||||
# the release target folder (dependencies compiled once; a version bump recompiles only the app crate)
|
||||
- uses: actions/cache@v4
|
||||
with:
|
||||
path: /tmp/storebound-target
|
||||
key: desktop-target-${{ runner.os }}-${{ hashFiles('apps/desktop/src-tauri/Cargo.lock') }}
|
||||
restore-keys: desktop-target-${{ runner.os }}-
|
||||
- name: Install and check
|
||||
run: |
|
||||
bun install --frozen-lockfile
|
||||
bun tools/desktop-version.ts
|
||||
bun tools/build-sidecars.ts --target bun-linux-x64
|
||||
# linuxdeploy (AppImage) sets the rpath of every executable with its own patchelf, which corrupts the bun
|
||||
# sidecar (segfault, then ldd fails in the gtk plugin). With the rpath already set (Ubuntu's patchelf, which
|
||||
# keeps it working), linuxdeploy leaves the file as it is. The sidecar needs only libc, so the rpath is inert.
|
||||
patchelf --set-rpath '$ORIGIN/../lib' apps/desktop/src-tauri/binaries/storebound-x86_64-unknown-linux-gnu
|
||||
apps/desktop/src-tauri/binaries/storebound-x86_64-unknown-linux-gnu version
|
||||
- name: Build AppImage and deb (path-free)
|
||||
working-directory: apps/desktop
|
||||
run: |
|
||||
rm -rf "$CARGO_TARGET_DIR/release/bundle"
|
||||
# the AppImage tools come from GitHub releases, which answer 504 now and then (cached in ~/.cache/tauri)
|
||||
bash ../../tools/ci-tauri-tools.sh
|
||||
for i in 1 2 3; do bun ../../tools/desktop-release.ts exec -- bunx tauri build --bundles appimage,deb --ci && break; [ $i = 3 ] && exit 1; sleep 30; done
|
||||
- name: Self-test the exact artifacts
|
||||
run: |
|
||||
V=$(bun tools/desktop-version.ts --print)
|
||||
B="$CARGO_TARGET_DIR/release/bundle"
|
||||
mkdir -p out && cp "$B/appimage/storebound_${V}_amd64.AppImage" "$B/deb/storebound_${V}_amd64.deb" out/
|
||||
chmod +x out/*.AppImage
|
||||
(cd /tmp && rm -rf squashfs-root && "$GITHUB_WORKSPACE/out/storebound_${V}_amd64.AppImage" --appimage-extract >/dev/null && squashfs-root/usr/bin/storebound-desktop --self-test)
|
||||
rm -rf /tmp/deb && dpkg-deb -x "out/storebound_${V}_amd64.deb" /tmp/deb && /tmp/deb/usr/bin/storebound-desktop --self-test
|
||||
dpkg-deb -I "out/storebound_${V}_amd64.deb" | sed -n '1,20p'
|
||||
- name: Start the app under Xvfb (AppImage and deb)
|
||||
# --self-test checks only the sidecar; this opens the real window (GTK, WebKitGTK, the bundled libraries of the
|
||||
# AppImage) on a virtual display. "sidecar started" in host.log means the webview ran the UI and called the host.
|
||||
run: |
|
||||
sudo apt-get install -y -qq --no-install-recommends xvfb xauth dbus-x11 >/dev/null
|
||||
V=$(bun tools/desktop-version.ts --print)
|
||||
smoke() { # <label> <executable>
|
||||
local d; d=$(mktemp -d); local log="$d/data/dev.storebound.desktop/logs/host.log"
|
||||
XDG_DATA_HOME="$d/data" XDG_CONFIG_HOME="$d/config" XDG_CACHE_HOME="$d/cache" \
|
||||
xvfb-run -a dbus-run-session -- "$2" >"$d/out.txt" 2>&1 &
|
||||
local pid=$! ok=0
|
||||
for i in $(seq 1 90); do
|
||||
if grep -q 'sidecar started' "$log" 2>/dev/null; then ok=1; break; fi
|
||||
kill -0 "$pid" 2>/dev/null || break
|
||||
sleep 1
|
||||
done
|
||||
sleep 3; kill -0 "$pid" 2>/dev/null || ok=0
|
||||
pkill -TERM -f storebound-desktop || true; wait "$pid" 2>/dev/null || true
|
||||
echo "--- $1 host.log"; cat "$log" 2>/dev/null || true
|
||||
local wv="$d/data/dev.storebound.desktop/logs/webview.log"
|
||||
if [ -f "$wv" ]; then echo "--- $1 webview.log"; cat "$wv"; grep -qE '^\S+ error ' "$wv" && ok=0; fi
|
||||
grep -qE '^\S+ error |panicked' "$log" 2>/dev/null && ok=0
|
||||
if [ "$ok" != 1 ]; then echo "--- $1 output"; tail -n 60 "$d/out.txt"; echo "$1: the window did not start the UI" >&2; return 1; fi
|
||||
echo "$1: window started, UI reached the sidecar"
|
||||
}
|
||||
smoke AppImage "$GITHUB_WORKSPACE/out/storebound_${V}_amd64.AppImage"
|
||||
smoke deb /tmp/deb/usr/bin/storebound-desktop
|
||||
- name: Privacy scan (with the private terms; never printed)
|
||||
env:
|
||||
FORBIDDEN_TERMS: ${{ secrets.FORBIDDEN_TERMS }}
|
||||
run: |
|
||||
[ -n "$FORBIDDEN_TERMS" ] || { echo "secret FORBIDDEN_TERMS is missing" >&2; exit 1; }
|
||||
umask 077; printf '%s\n' "$FORBIDDEN_TERMS" > "$RUNNER_TEMP/terms.txt"
|
||||
rc=0; STOREBOUND_FORBIDDEN_TERMS="$RUNNER_TEMP/terms.txt" bun tools/privacy-scan.ts out/ || rc=$?
|
||||
rm -f "$RUNNER_TEMP/terms.txt"; exit $rc
|
||||
- uses: actions/upload-artifact@v3
|
||||
with:
|
||||
name: storebound-desktop-linux
|
||||
path: out/
|
||||
retention-days: 7
|
||||
# dev channel (tools/desktop-dev.ts): the same commit again with the version <next patch>-dev.<commit UTC>, only in
|
||||
# this workspace (never committed); a failure here never touches the release candidate above
|
||||
- name: Dev build (AppImage + deb, dev version)
|
||||
id: dev
|
||||
if: github.event_name == 'push' && github.ref == 'refs/heads/main'
|
||||
continue-on-error: true
|
||||
env:
|
||||
FORBIDDEN_TERMS: ${{ secrets.FORBIDDEN_TERMS }}
|
||||
run: |
|
||||
set -euo pipefail
|
||||
V=$(bun tools/desktop-dev.ts set)
|
||||
bun tools/build-sidecars.ts --target bun-linux-x64
|
||||
patchelf --set-rpath '$ORIGIN/../lib' apps/desktop/src-tauri/binaries/storebound-x86_64-unknown-linux-gnu
|
||||
B="$CARGO_TARGET_DIR/release/bundle"; rm -rf "$B"
|
||||
bash tools/ci-tauri-tools.sh
|
||||
for i in 1 2 3; do (cd apps/desktop && bun ../../tools/desktop-release.ts exec -- bunx tauri build --bundles appimage,deb --ci) && break; [ $i = 3 ] && exit 1; sleep 30; done
|
||||
mkdir -p dev && cp "$B/appimage/storebound_${V}_amd64.AppImage" "$B/deb/storebound_${V}_amd64.deb" dev/
|
||||
chmod +x dev/*.AppImage
|
||||
(cd /tmp && rm -rf squashfs-root && "$GITHUB_WORKSPACE/dev/storebound_${V}_amd64.AppImage" --appimage-extract >/dev/null && squashfs-root/usr/bin/storebound-desktop --self-test)
|
||||
umask 077; printf '%s\n' "$FORBIDDEN_TERMS" > "$RUNNER_TEMP/terms.txt"
|
||||
rc=0; STOREBOUND_FORBIDDEN_TERMS="$RUNNER_TEMP/terms.txt" bun tools/privacy-scan.ts dev/ || rc=$?
|
||||
rm -f "$RUNNER_TEMP/terms.txt"; git checkout -- . ; exit $rc
|
||||
- uses: actions/upload-artifact@v3
|
||||
if: steps.dev.outcome == 'success'
|
||||
with:
|
||||
name: storebound-desktop-dev-linux
|
||||
path: dev/
|
||||
retention-days: 3
|
||||
|
||||
windows:
|
||||
needs: gate
|
||||
if: github.event_name != 'pull_request'
|
||||
# the Windows runner on the VDS ("windows" label, host mode): Rust (MSVC), Bun, 7-Zip, pwsh
|
||||
runs-on: windows
|
||||
timeout-minutes: 90
|
||||
env:
|
||||
CARGO_TARGET_DIR: C:\storebound-target
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version: '20'
|
||||
- name: Install and check
|
||||
shell: pwsh
|
||||
run: |
|
||||
bun install --frozen-lockfile
|
||||
bun tools/desktop-version.ts
|
||||
bun tools/build-sidecars.ts --target bun-windows-x64
|
||||
- name: Node bundle on Windows (npx storebound) - stdin prompts read with node, clean exit
|
||||
shell: pwsh
|
||||
run: |
|
||||
bun tools/build-node.ts
|
||||
node --version
|
||||
bun tools/node-smoke.ts --only prompt
|
||||
if ($LASTEXITCODE -ne 0) { throw "node prompt smoke failed" }
|
||||
"n" | node dist/storebound.mjs --version
|
||||
if ($LASTEXITCODE -ne 0) { throw "node dist/storebound.mjs --version failed" }
|
||||
- name: Build NSIS installer (per user, WebView2 bootstrapper, path-free)
|
||||
shell: pwsh
|
||||
working-directory: apps/desktop
|
||||
run: |
|
||||
Remove-Item -Recurse -Force "$env:CARGO_TARGET_DIR\release\bundle\nsis" -ErrorAction SilentlyContinue
|
||||
bun ../../tools/desktop-release.ts exec -- bunx tauri build --bundles nsis --ci
|
||||
- name: Install per user, self-test, uninstall
|
||||
shell: pwsh
|
||||
run: |
|
||||
$V = bun tools/desktop-version.ts --print
|
||||
New-Item -ItemType Directory -Force out | Out-Null
|
||||
Copy-Item "$env:CARGO_TARGET_DIR\release\bundle\nsis\storebound_${V}_x64-setup.exe" out\
|
||||
Start-Process -Wait -FilePath "out\storebound_${V}_x64-setup.exe" -ArgumentList '/S'
|
||||
$exe = "$env:LOCALAPPDATA\storebound\storebound-desktop.exe"
|
||||
if (-not (Test-Path $exe)) { throw "not installed per user at $exe" }
|
||||
& $exe --self-test | Tee-Object -Variable st
|
||||
if ($LASTEXITCODE -ne 0) { throw "self-test failed" }
|
||||
Start-Process -Wait -FilePath "$env:LOCALAPPDATA\storebound\uninstall.exe" -ArgumentList '/S'
|
||||
- name: Privacy scan (no .pdb, no paths; with the private terms, never printed)
|
||||
shell: pwsh
|
||||
env:
|
||||
FORBIDDEN_TERMS: ${{ secrets.FORBIDDEN_TERMS }}
|
||||
run: |
|
||||
if (-not $env:FORBIDDEN_TERMS) { throw "secret FORBIDDEN_TERMS is missing" }
|
||||
$t = Join-Path $env:RUNNER_TEMP "terms-$([guid]::NewGuid()).txt"
|
||||
Set-Content -Path $t -Value $env:FORBIDDEN_TERMS -NoNewline:$false
|
||||
$env:STOREBOUND_FORBIDDEN_TERMS = $t
|
||||
bun tools/privacy-scan.ts out
|
||||
$rc = $LASTEXITCODE
|
||||
Remove-Item -Force $t
|
||||
if ($rc -ne 0) { throw "privacy scan failed" }
|
||||
- uses: actions/upload-artifact@v3
|
||||
with:
|
||||
name: storebound-desktop-windows
|
||||
path: out/
|
||||
retention-days: 7
|
||||
# dev channel (tools/desktop-dev.ts): see the linux job
|
||||
- name: Dev build (NSIS, dev version)
|
||||
id: dev
|
||||
if: github.event_name == 'push' && github.ref == 'refs/heads/main'
|
||||
continue-on-error: true
|
||||
shell: pwsh
|
||||
env:
|
||||
FORBIDDEN_TERMS: ${{ secrets.FORBIDDEN_TERMS }}
|
||||
run: |
|
||||
$ErrorActionPreference = 'Stop'
|
||||
$V = bun tools/desktop-dev.ts set
|
||||
if ($LASTEXITCODE -ne 0) { throw "dev version stamp refused" }
|
||||
bun tools/build-sidecars.ts --target bun-windows-x64
|
||||
Remove-Item -Recurse -Force "$env:CARGO_TARGET_DIR\release\bundle\nsis" -ErrorAction SilentlyContinue
|
||||
Push-Location apps/desktop
|
||||
bun ../../tools/desktop-release.ts exec -- bunx tauri build --bundles nsis --ci
|
||||
if ($LASTEXITCODE -ne 0) { throw "dev build failed" }
|
||||
Pop-Location
|
||||
New-Item -ItemType Directory -Force dev | Out-Null
|
||||
Copy-Item "$env:CARGO_TARGET_DIR\release\bundle\nsis\storebound_${V}_x64-setup.exe" dev\
|
||||
Start-Process -Wait -FilePath "dev\storebound_${V}_x64-setup.exe" -ArgumentList '/S'
|
||||
& "$env:LOCALAPPDATA\storebound\storebound-desktop.exe" --self-test
|
||||
if ($LASTEXITCODE -ne 0) { throw "dev self-test failed" }
|
||||
Start-Process -Wait -FilePath "$env:LOCALAPPDATA\storebound\uninstall.exe" -ArgumentList '/S'
|
||||
$t = Join-Path $env:RUNNER_TEMP "terms-$([guid]::NewGuid()).txt"
|
||||
Set-Content -Path $t -Value $env:FORBIDDEN_TERMS -NoNewline:$false
|
||||
$env:STOREBOUND_FORBIDDEN_TERMS = $t
|
||||
bun tools/privacy-scan.ts dev
|
||||
$rc = $LASTEXITCODE
|
||||
Remove-Item -Force $t
|
||||
git checkout -- .
|
||||
if ($rc -ne 0) { throw "privacy scan failed" }
|
||||
- uses: actions/upload-artifact@v3
|
||||
if: steps.dev.outcome == 'success'
|
||||
with:
|
||||
name: storebound-desktop-dev-windows
|
||||
path: dev/
|
||||
retention-days: 3
|
||||
|
||||
# dev channel: the dev bundles of both jobs go to a Forgejo draft dev-<version> (no tag; the newest 5 kept); the VDS
|
||||
# (tools/vds/storebound-desktop-dev, a root timer) signs them with the updater key and publishes
|
||||
# storebound.dev/desktop/dev/latest.json. macOS has no dev build: Developer ID signing needs the Mac's GUI session.
|
||||
dev:
|
||||
needs: [linux, windows]
|
||||
if: ${{ always() && github.event_name == 'push' && github.ref == 'refs/heads/main' && needs.linux.result == 'success' && needs.windows.result == 'success' }}
|
||||
runs-on: ubuntu-22.04
|
||||
timeout-minutes: 40
|
||||
env:
|
||||
FORGEJO_TOKEN: ${{ secrets.RELEASE_TOKEN }}
|
||||
FORGEJO_URL: ${{ github.server_url }}
|
||||
FORGEJO_ORIGIN: ${{ secrets.FORGEJO_ORIGIN }}
|
||||
SHA: ${{ github.sha }}
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- name: Tools
|
||||
run: |
|
||||
bash tools/ci-install-bun.sh
|
||||
echo "$HOME/.bun/bin" >> "${FORGEJO_PATH:-$GITHUB_PATH}"
|
||||
- uses: actions/download-artifact@v3
|
||||
with:
|
||||
name: storebound-desktop-dev-linux
|
||||
path: dev
|
||||
- uses: actions/download-artifact@v3
|
||||
with:
|
||||
name: storebound-desktop-dev-windows
|
||||
path: dev
|
||||
- name: Draft dev-<version> (newest 5 kept), then wait for the VDS to publish it
|
||||
run: |
|
||||
ls -la dev
|
||||
bun tools/desktop-dev.ts record --dir dev --yes
|
||||
V=$(ls dev | sed -n 's/^storebound_\(.*\)_x64-setup\.exe$/\1/p')
|
||||
bun tools/desktop-dev.ts wait "$V" --minutes 20
|
||||
|
||||
record:
|
||||
needs: [gate, linux, windows]
|
||||
if: ${{ always() && github.event_name != 'pull_request' && needs.gate.result == 'success' && needs.linux.result == 'success' && needs.windows.result == 'success' }}
|
||||
runs-on: ubuntu-22.04
|
||||
timeout-minutes: 30
|
||||
env:
|
||||
FORGEJO_TOKEN: ${{ secrets.RELEASE_TOKEN }}
|
||||
FORGEJO_URL: ${{ github.server_url }}
|
||||
# uploads over 100 MB go to the origin directly (Cloudflare refuses them): tools/forgejo-release.ts
|
||||
FORGEJO_ORIGIN: ${{ secrets.FORGEJO_ORIGIN }}
|
||||
SHA: ${{ github.sha }}
|
||||
REUSE: ${{ needs.gate.outputs.reuse }}
|
||||
FROM: ${{ needs.gate.outputs.from }}
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
# no apt: the installers were scanned with the private terms in their own jobs; this job only records
|
||||
- name: Tools
|
||||
run: |
|
||||
bash tools/ci-install-bun.sh
|
||||
echo "$HOME/.bun/bin" >> "${FORGEJO_PATH:-$GITHUB_PATH}"
|
||||
[ -n "$FORGEJO_TOKEN" ] || { echo "secret RELEASE_TOKEN is missing (repo Settings > Actions > Secrets)" >&2; exit 1; }
|
||||
- uses: actions/download-artifact@v3
|
||||
with:
|
||||
name: storebound-desktop-linux
|
||||
path: cand
|
||||
- uses: actions/download-artifact@v3
|
||||
with:
|
||||
name: storebound-desktop-windows
|
||||
path: cand
|
||||
- name: Checksums file of the build jobs is not shipped as is
|
||||
run: rm -f cand/SHA256SUMS
|
||||
- name: Record the candidate (draft rc-<sha>, green.json last)
|
||||
run: |
|
||||
bun tools/release-candidate.ts record --sha "$SHA" --run "$GITHUB_SERVER_URL/$GITHUB_REPOSITORY/actions/runs/$GITHUB_RUN_NUMBER" --dir cand ${FROM:+--reused-from "$FROM"} --yes
|
||||
bun tools/release-candidate.ts prune --keep 12 --yes
|
||||
78
.forgejo/workflows/release.yml
Normal file
|
|
@ -0,0 +1,78 @@
|
|||
# The release of storebound: a version tag (v0.8.5) promotes the release candidate of its commit. Nothing is rebuilt
|
||||
# or retested here: ci.yml ran the full CI, the acceptance matrix (Linux + Windows x Node 20 / 22 / Bun) and built,
|
||||
# self-tested and privacy-scanned the Linux and Windows installers for that very commit (for a version-only bump
|
||||
# commit: the installers, with the parent's CI and matrix, proven version-only file by file), and stored them as the
|
||||
# draft rc-<sha> with green.json (tools/release-candidate.ts).
|
||||
#
|
||||
# push of a tag v* checks (tag = package.json version, every version copy equal, the CHANGELOG section), waits
|
||||
# for the commit's candidate (heartbeat; fails at once when the commit is red or has no ci run,
|
||||
# with the run's link; times out after 40 min), then ONE release "storebound <version>" with the
|
||||
# candidate's installers, the acceptance matrix, SHA256SUMS and short notes. Stable versions
|
||||
# then delete the older release entries (tags stay). A version with a "-" (0.0.0-rehearsal.1)
|
||||
# is a prerelease: never pruning, never the stable release.
|
||||
# workflow_dispatch tag: the same for an existing tag; dry (default): only the plan.
|
||||
#
|
||||
# Not here: macOS. tools/release.ts on the owner's Mac builds, signs and notarizes the DMG in parallel and adds it to
|
||||
# this release, then publishes storebound.dev (docs/desktop-release.md). The updater signing key never reaches a runner.
|
||||
# Secrets: RELEASE_TOKEN (scope write:repository), FORGEJO_ORIGIN (the server's IP: uploads over 100 MB bypass
|
||||
# Cloudflare). The private terms scan of the installers ran in ci.yml's build jobs (FORBIDDEN_TERMS).
|
||||
name: release
|
||||
|
||||
on:
|
||||
push:
|
||||
tags: ['v*']
|
||||
workflow_dispatch:
|
||||
inputs:
|
||||
tag:
|
||||
description: Version tag to release (v0.8.5)
|
||||
type: string
|
||||
default: ''
|
||||
dry:
|
||||
description: Dry run (only the plan)
|
||||
type: boolean
|
||||
default: true
|
||||
|
||||
env:
|
||||
BUN_VERSION: '1.4.0'
|
||||
|
||||
jobs:
|
||||
promote:
|
||||
runs-on: ubuntu-22.04
|
||||
timeout-minutes: 50
|
||||
env:
|
||||
FORGEJO_TOKEN: ${{ secrets.RELEASE_TOKEN }}
|
||||
FORGEJO_URL: ${{ github.server_url }}
|
||||
FORGEJO_ORIGIN: ${{ secrets.FORGEJO_ORIGIN }}
|
||||
TAG: ${{ github.event_name == 'push' && github.ref_name || inputs.tag }}
|
||||
steps:
|
||||
- name: Mode
|
||||
id: mode
|
||||
env:
|
||||
EVENT: ${{ github.event_name }}
|
||||
IN_DRY: ${{ inputs.dry }}
|
||||
run: |
|
||||
[ -n "$TAG" ] || { echo "input tag is required" >&2; exit 1; }
|
||||
case "$(echo "${IN_DRY:-true}" | tr A-Z a-z)" in false|0|off|no) dry=false;; *) dry=true;; esac
|
||||
[ "$EVENT" = push ] && dry=false
|
||||
echo "dry=$dry" >> "$GITHUB_OUTPUT"; echo "tag=$TAG dry=$dry"
|
||||
- uses: actions/checkout@v4
|
||||
with:
|
||||
ref: refs/tags/${{ env.TAG }}
|
||||
- name: Tag, package.json version, every version copy and the CHANGELOG agree
|
||||
id: check
|
||||
run: |
|
||||
bash tools/ci-install-bun.sh
|
||||
echo "$HOME/.bun/bin" >> "${FORGEJO_PATH:-$GITHUB_PATH}"
|
||||
export PATH="$HOME/.bun/bin:$PATH"
|
||||
bun tools/desktop-version.ts
|
||||
V=$(bun tools/desktop-version.ts --print)
|
||||
[ "$TAG" = "v$V" ] || { echo "tag $TAG is not v$V (package.json): bun tools/release.ts <version> makes the bump commit and the tag" >&2; exit 1; }
|
||||
case "$V" in *-*) echo "prerelease $V: the CHANGELOG section is optional";; *) grep -q "^## $V" CHANGELOG.md || { echo "CHANGELOG.md has no '## $V' section" >&2; exit 1; };; esac
|
||||
[ -n "$FORGEJO_TOKEN" ] || { echo "secret RELEASE_TOKEN is missing (repo Settings > Actions > Secrets)" >&2; exit 1; }
|
||||
echo "sha=$(git rev-parse HEAD)" >> "$GITHUB_OUTPUT"
|
||||
echo "version=$V" >> "$GITHUB_OUTPUT"
|
||||
- name: Promote the commit's green candidate
|
||||
run: bun tools/release-candidate.ts promote --tag "$TAG" --sha "${{ steps.check.outputs.sha }}" --wait 40 ${{ steps.mode.outputs.dry == 'false' && '--yes' || '' }}
|
||||
- name: Keep only the newest release (stable versions; tags stay)
|
||||
if: ${{ steps.mode.outputs.dry == 'false' && !contains(steps.check.outputs.version, '-') }}
|
||||
run: bun tools/forgejo-release.ts prune --keep "$TAG" --yes
|
||||
13
.gitattributes
vendored
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
* text=auto eol=lf
|
||||
*.png binary
|
||||
*.jpg binary
|
||||
*.ico binary
|
||||
*.icns binary
|
||||
*.ttf binary
|
||||
*.woff2 binary
|
||||
*.mp4 binary
|
||||
*.bat text eol=crlf
|
||||
*.cmd text eol=crlf
|
||||
# kept byte-for-byte as published upstream (CRLF)
|
||||
cli/data/play-data-safety-form.csv -text
|
||||
**/icons/LICENSE.txt -text
|
||||
95
.github/copilot-instructions.md
vendored
|
|
@ -7,20 +7,62 @@ format; `storebound install --agent copilot` copies them to `.github/skills/` of
|
|||
|
||||
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
||||
|
||||
1. **The owner decides public and irreversible steps.** Submitting for review (App Review or Beta App Review),
|
||||
releasing a version, resuming or completing a rollout, canceling a submission, deleting products or listings,
|
||||
accepting agreements, sending review replies, inviting or removing testers, changing prices, starting or stopping
|
||||
a store experiment: explain what will happen and let the owner do it (or run the command only after a clear yes in
|
||||
chat). storebound's MCP server does not offer these at all.
|
||||
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
||||
for real only after the owner agrees.
|
||||
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
||||
what is missing and in which order to fix it.
|
||||
4. **Credentials only from the environment or `.storebound/`** in the project (gitignored). Never ask for keys,
|
||||
## First rule: do it, don't ask
|
||||
|
||||
storebound plus you, the AI agent, do the work. The owner is not your pair of hands.
|
||||
|
||||
1. **You do everything yourself:** API calls, uploads, builds, template and CSV downloads and exports, every console
|
||||
navigation (open, Get Started, Edit, Next, Continue, Save draft), console forms, and the verification afterwards.
|
||||
Never tell the owner "run this yourself" or "click X yourself" for any of these.
|
||||
2. **The owner keeps only the final public or irreversible buttons:** Submit for review (App Review or Beta App
|
||||
Review), releasing a version or completing / resuming a production rollout, App Privacy Publish, accepting legal
|
||||
agreements; plus deleting store data, changing live prices, sending review replies and inviting or removing
|
||||
testers. (Also the owner's: canceling a submission, starting or stopping a store experiment, a console form's final
|
||||
Submit / Create that a console plan lists in `buttons.final`, signing in and granting account permissions.) For
|
||||
these you prepare everything, show the dry run, and the owner presses one button or says yes.
|
||||
**Updates are agent steps:** a new version of an app that is already on the store (Play: the production track holds
|
||||
a published release; App Store: a version of the platform is or was on sale) is yours end to end, no owner gate
|
||||
per update: `storebound play release <aab> --production completed --yes`, `storebound play upload --track
|
||||
production --yes`, `storebound apple submit --build <n> --yes`, `storebound apple release --manual-release --yes`
|
||||
(docs/bypass.md). Only the **first-ever release** of an app stays the owner's (exit 3 `OWNER_STEP`: after the
|
||||
owner's yes re-run with `--first-release`), plus removal from sale, live price changes and anything that costs money.
|
||||
**Bypass mode** (`storebound settings bypass status`): when the owner turned it on, you run these owner steps too:
|
||||
MCP `owner_step` (dry run first, then `dry_run: false`), `storebound api ... --yes --confirm <operationId>`, and
|
||||
console plans' `buttons.final`. Say in one line what you pressed; every action is logged to
|
||||
`.storebound/owner-actions.log`. Legal agreements, passwords and 2FA stay with the owner if your own rules say so.
|
||||
3. **Ask the owner only for facts that no code, config or doc can prove:** compliance answers such as Data safety,
|
||||
App Privacy, age rating, export compliance, partial data deletion. Collect ALL of them in ONE batch at the start
|
||||
(`storebound check` and `storebound validate` list them), never one at a time during the run. Reuse answers that
|
||||
are already in the config.
|
||||
4. **Default loop:** plan, then you drive (the API first, your browser tool for consoles without an API), then verify
|
||||
(read it back), then continue. No round trip to the owner in between.
|
||||
5. **Catch rejections offline.** Before a write, `storebound check` and `--dry` must catch what the store would refuse
|
||||
(live-shape fixtures, id and pair checks). A failure belongs in the dry run, not in a 400 at write time; when a
|
||||
store refuses something the dry run passed, fix the check (pitfalls), not just the data.
|
||||
|
||||
Every hour of "please click this" is an hour the owner did not want to spend. If you catch yourself writing "you
|
||||
need to ...", do it instead, unless it is one of the owner steps in point 2.
|
||||
|
||||
## The other rules
|
||||
|
||||
**Read `skills/store-pitfalls/SKILL.md` before any store task.** It lists the mistakes already made in real releases
|
||||
(store lists that lag after a create, dry runs without a plan, taken App Store names, byte limits, ...) and what to do.
|
||||
|
||||
1. **The owner presses only the owner steps** (point 2 of the first rule). Prepare them completely, say what will
|
||||
happen, and let the owner press the button, or run the command only after a clear yes in chat. storebound's MCP
|
||||
server does not offer these at all. Everything else you run yourself.
|
||||
2. **Dry run first, then run it yourself.** Every write command has `--dry` (MCP: `dry_run`, default true). Run the
|
||||
dry run, check and show it (the rows that change, not just a count), then run the real command yourself (`--yes`
|
||||
where it asks for a confirmation) and read the result back. Wait for the owner's yes only before an owner step.
|
||||
3. **Read before you write.** `storebound scan` (offline: rejection risks in the project itself), `storebound check`
|
||||
(offline) and `storebound validate` (read-only, both stores) tell you what is missing and in which order to fix it.
|
||||
4. **Credentials only from the environment, `.storebound/`** in the project (gitignored) **or a credential profile**
|
||||
(`~/.storebound/credentials/<profile>.json`, named by `--account <profile>` or a workspace). Never ask for keys,
|
||||
passwords or tokens in chat, never print them, never write them into the config, docs or commits. The same goes
|
||||
for the App Review demo account (`reviewDemoAccount` in `.storebound/credentials.json`): the owner puts it there.
|
||||
5. **Never answer a compliance question you cannot know.** Export compliance, Data safety, App Privacy, age rating,
|
||||
target audience: ask the owner when the code does not prove the answer. A wrong "no" is worse than a slow "ask".
|
||||
target audience: ask the owner when the code does not prove the answer, all such questions in one batch at the
|
||||
start (first rule, point 3), and write the answers into the config. A wrong "no" is worse than a slow "ask".
|
||||
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
||||
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
||||
you report the progress lines, not guesses.
|
||||
|
|
@ -29,39 +71,64 @@ These rules apply to every AI tool that uses storebound (skills, MCP server or t
|
|||
9. **Personal data stays local.** Tester lists, review reply drafts, health reports and analytics snapshots live in
|
||||
`.storebound/` (gitignored). Never put tester emails, reviewer names or crash logs into issues, docs or commits,
|
||||
and never ask for tester emails in chat (storebound masks them in its output).
|
||||
10. **Console forms without an API: drive them yourself, agent-first.** `storebound console plan <form> --json` (MCP
|
||||
`console_plan`) gives the start URL, steps, the answer sheet, the buttons you must never press and the verified UI
|
||||
facts. Drive the page with your own browser tool, adapt to what it shows, run long flows as an in-page async loop
|
||||
that writes `window.__log` (one evaluate call times out around 45 s), stop only before the final button (Publish,
|
||||
Submit, Create, a final Save) and tell the owner exactly what to press, then `storebound console verify <form>`.
|
||||
Never sign in, accept an agreement or grant a permission (a service account's app access) for the owner.
|
||||
`storebound console fill` is the optional scripted fast path; it never blocks you.
|
||||
11. **Console pages: always the absolute deep link.** When you send the owner to a console page, give the absolute
|
||||
deep link (storebound prints it; `storebound console plan` has start URLs), never just "go to App Store Connect"
|
||||
or "App Store Connect > App Information" alone.
|
||||
|
||||
## Tools
|
||||
|
||||
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||
- CLI: `storebound <command>` (`storebound help`; outside the plugin: `npx storebound` on Node 20+ or `bunx storebound` on Bun); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||
- MCP: `storebound mcp` (stdio). MCP 2026-07-28 + 2025-11-25. Write tools default to `dry_run: true`; submit / release / cancel / delete / send are not exposed.
|
||||
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||
- Readiness: `storebound scan` (offline rejection risks in the project files), `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||
- Every endpoint: `storebound api apple|play <operationId>` (skill store-api). GETs run; writes are dry unless the owner adds `--yes` in a terminal; MCP has the read-only `api_get`.
|
||||
|
||||
## Skills
|
||||
|
||||
| skill | for |
|
||||
|---|---|
|
||||
| `account-deletion` | Make account deletion pass App Store and Google Play review for an app with sign-up or sign-in |
|
||||
| `adhoc-distribution` | Get a test build of a mobile app or game onto specific devices without a store review |
|
||||
| `ads-levelplay-checks` | Renamed to ads-mediation-checks (AdMob, AppLovin MAX and Unity LevelPlay / ironSource). Kept so existing installs and links keep working. Use ads-mediation-checks for any ad mediation, app-ads.txt, SKAdNetwork or "no fill" question |
|
||||
| `ads-mediation-checks` | Diagnose and verify ad mediation in a mobile app or game before and after store release |
|
||||
| `app-icons` | Generate every icon a mobile app or game needs from one artwork |
|
||||
| `app-previews` | Make App Store app preview videos and a Google Play promo video for a mobile app or game from real footage (gameplay or app flows) |
|
||||
| `app-store-promotion` | App Store promotion tools for a mobile app or game through the App Store Connect API |
|
||||
| `apple-ads` | Read Apple Ads (formerly Apple Search Ads) results for a mobile app or game and make small, owner-approved bid, daily budget and pause changes |
|
||||
| `appstore-first-release` | Step-by-step first (and later) App Store release of a mobile app or game |
|
||||
| `aso-basics` | App store optimization basics for a mobile app's or game's text |
|
||||
| `build-and-sign` | Sign, build and upload a mobile app or game from the terminal |
|
||||
| `console-autofill` | Fill App Store Connect and Google Play Console forms that have no API (New App, App Privacy, Play Create app, IARC content rating, every Play App content card, Play Store settings category, first production release countries and send-for-review). Agent-first by default |
|
||||
| `export-compliance` | Answer App Store export compliance (encryption) for a mobile app or game correctly |
|
||||
| `game-services` | Set up Game Center (App Store) and Play Games Services (Google Play) for a mobile game from one config section |
|
||||
| `listing-localization` | Translate the store listing of a mobile app or game into more languages |
|
||||
| `migrate-from-fastlane` | Move a mobile app or game from fastlane (deliver, supply, snapshot / screengrab, Appfile, Deliverfile) to storebound with `storebound import fastlane` |
|
||||
| `play-first-release` | Step-by-step first (and later) Google Play release of a mobile app or game |
|
||||
| `portfolio-originality` | Originality gate for studios and developers that ship many similar mobile apps or games (templates, white-label apps, reskins) |
|
||||
| `ppp-pricing` | Propose purchasing power parity (PPP) prices for a mobile app's or game's in-app products in every App Store territory and Google Play region with `storebound prices ppp` |
|
||||
| `privacy-manifest` | Add and check Apple privacy manifests (PrivacyInfo.xcprivacy) for an iOS app or game |
|
||||
| `privacy-policy` | Write and host one studio-wide privacy policy page for all of a developer's mobile apps and games |
|
||||
| `release-flows` | Repo-local workflows for a mobile app or game |
|
||||
| `release-management` | Ship updates safely after the first release |
|
||||
| `revenuecat-sync` | Optional adapter that keeps a RevenueCat project's catalog in step with the storebound config |
|
||||
| `review-access` | Give App Store and Google Play reviewers working access to an app behind a sign-in |
|
||||
| `review-rejections` | Triage and answer an App Store or Google Play rejection, policy warning or strike for a mobile app or game |
|
||||
| `review-replies` | Reply to App Store and Google Play reviews of a mobile app or game the safe way |
|
||||
| `store-analytics` | Take store analytics snapshots for a mobile app or game (App Store impressions, product page views, downloads and conversion through the Analytics Reports API; Google Play store listing visitors, acquisitions and installs from the Play reports bucket) and compare them with listing, screenshot and experiment changes from git |
|
||||
| `store-analytics` | Take store analytics snapshots for a mobile app or game (App Store impressions, product page views, downloads and conversion through the Analytics Reports API; Google Play store listing visitors, acquisitions and installs from the Play reports bucket) and compare them with listing, screenshot and experiment changes from git; download App Store sales / finance reports and Play earnings / sales reports with a summary per product and currency |
|
||||
| `store-api` | Call any App Store Connect API or Google Play Developer API operation that storebound's commands do not wrap, safely |
|
||||
| `store-declarations` | Answer the store compliance forms for a mobile app or game |
|
||||
| `store-health` | Watch a released mobile app's or game's crash and ANR health on both stores |
|
||||
| `store-iap-setup` | Create and price in-app purchases (consumables, non-consumables like "remove ads" or a Pro unlock, non-renewing passes, coin/gem packs, starter packs) on Google Play and App Store Connect from one product list |
|
||||
| `store-pitfalls` | Known pitfalls with App Store Connect, Google Play and storebound itself, learned from real releases, and what to do about each |
|
||||
| `store-preflight` | Run and read the storebound readiness checks before submitting a mobile app or game |
|
||||
| `store-screenshots` | Produce store screenshots and the Play feature graphic for a mobile app or game in every required size and many languages |
|
||||
| `store-subscriptions` | Set up auto-renewable subscriptions on the App Store and Google Play from one config |
|
||||
| `testflight` | Run TestFlight for a mobile app or game through the App Store Connect API |
|
||||
| `web-presence` | Set up the web side of a mobile app or game |
|
||||
| `whats-new` | Write user-facing release notes ("What's new") for a mobile app or game update from the git log since the last tag |
|
||||
|
|
|
|||
14
.gitignore
vendored
|
|
@ -7,3 +7,17 @@ node_modules/
|
|||
*.p12
|
||||
.DS_Store
|
||||
media/teaser/out/
|
||||
|
||||
# desktop app (apps/desktop): build output, compiled sidecars, Tauri generated schemas
|
||||
apps/desktop/dist/
|
||||
apps/desktop/src-tauri/target/
|
||||
apps/desktop/src-tauri/binaries/
|
||||
apps/desktop/src-tauri/gen/
|
||||
apps/desktop/.screens/
|
||||
.scratch/
|
||||
|
||||
# scan fixtures: a monorepo whose Capacitor plugins live in apps/native/node_modules
|
||||
!tests/fixtures/scan/monorepo/apps/native/node_modules/
|
||||
|
||||
# npm bundle (bun tools/build-node.ts; npm pack / publish build it)
|
||||
/dist/
|
||||
|
|
|
|||
|
|
@ -1,9 +1,10 @@
|
|||
{
|
||||
"mcpServers": {
|
||||
"storebound": {
|
||||
"command": "${CLAUDE_PLUGIN_ROOT}/bin/storebound",
|
||||
"command": "sh",
|
||||
"args": [
|
||||
"mcp"
|
||||
"-c",
|
||||
"r=\"${CLAUDE_PLUGIN_ROOT:-}\"; if [ -n \"$r\" ] && [ -x \"$r/bin/storebound\" ]; then exec \"$r/bin/storebound\" mcp; fi; if command -v storebound >/dev/null 2>&1; then exec storebound mcp; fi; exec npx -y storebound@latest mcp"
|
||||
]
|
||||
}
|
||||
}
|
||||
|
|
|
|||
99
AGENTS.md
|
|
@ -8,20 +8,62 @@ file below and follow it step by step.
|
|||
|
||||
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
||||
|
||||
1. **The owner decides public and irreversible steps.** Submitting for review (App Review or Beta App Review),
|
||||
releasing a version, resuming or completing a rollout, canceling a submission, deleting products or listings,
|
||||
accepting agreements, sending review replies, inviting or removing testers, changing prices, starting or stopping
|
||||
a store experiment: explain what will happen and let the owner do it (or run the command only after a clear yes in
|
||||
chat). storebound's MCP server does not offer these at all.
|
||||
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
||||
for real only after the owner agrees.
|
||||
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
||||
what is missing and in which order to fix it.
|
||||
4. **Credentials only from the environment or `.storebound/`** in the project (gitignored). Never ask for keys,
|
||||
## First rule: do it, don't ask
|
||||
|
||||
storebound plus you, the AI agent, do the work. The owner is not your pair of hands.
|
||||
|
||||
1. **You do everything yourself:** API calls, uploads, builds, template and CSV downloads and exports, every console
|
||||
navigation (open, Get Started, Edit, Next, Continue, Save draft), console forms, and the verification afterwards.
|
||||
Never tell the owner "run this yourself" or "click X yourself" for any of these.
|
||||
2. **The owner keeps only the final public or irreversible buttons:** Submit for review (App Review or Beta App
|
||||
Review), releasing a version or completing / resuming a production rollout, App Privacy Publish, accepting legal
|
||||
agreements; plus deleting store data, changing live prices, sending review replies and inviting or removing
|
||||
testers. (Also the owner's: canceling a submission, starting or stopping a store experiment, a console form's final
|
||||
Submit / Create that a console plan lists in `buttons.final`, signing in and granting account permissions.) For
|
||||
these you prepare everything, show the dry run, and the owner presses one button or says yes.
|
||||
**Updates are agent steps:** a new version of an app that is already on the store (Play: the production track holds
|
||||
a published release; App Store: a version of the platform is or was on sale) is yours end to end, no owner gate
|
||||
per update: `storebound play release <aab> --production completed --yes`, `storebound play upload --track
|
||||
production --yes`, `storebound apple submit --build <n> --yes`, `storebound apple release --manual-release --yes`
|
||||
(docs/bypass.md). Only the **first-ever release** of an app stays the owner's (exit 3 `OWNER_STEP`: after the
|
||||
owner's yes re-run with `--first-release`), plus removal from sale, live price changes and anything that costs money.
|
||||
**Bypass mode** (`storebound settings bypass status`): when the owner turned it on, you run these owner steps too:
|
||||
MCP `owner_step` (dry run first, then `dry_run: false`), `storebound api ... --yes --confirm <operationId>`, and
|
||||
console plans' `buttons.final`. Say in one line what you pressed; every action is logged to
|
||||
`.storebound/owner-actions.log`. Legal agreements, passwords and 2FA stay with the owner if your own rules say so.
|
||||
3. **Ask the owner only for facts that no code, config or doc can prove:** compliance answers such as Data safety,
|
||||
App Privacy, age rating, export compliance, partial data deletion. Collect ALL of them in ONE batch at the start
|
||||
(`storebound check` and `storebound validate` list them), never one at a time during the run. Reuse answers that
|
||||
are already in the config.
|
||||
4. **Default loop:** plan, then you drive (the API first, your browser tool for consoles without an API), then verify
|
||||
(read it back), then continue. No round trip to the owner in between.
|
||||
5. **Catch rejections offline.** Before a write, `storebound check` and `--dry` must catch what the store would refuse
|
||||
(live-shape fixtures, id and pair checks). A failure belongs in the dry run, not in a 400 at write time; when a
|
||||
store refuses something the dry run passed, fix the check (pitfalls), not just the data.
|
||||
|
||||
Every hour of "please click this" is an hour the owner did not want to spend. If you catch yourself writing "you
|
||||
need to ...", do it instead, unless it is one of the owner steps in point 2.
|
||||
|
||||
## The other rules
|
||||
|
||||
**Read `skills/store-pitfalls/SKILL.md` before any store task.** It lists the mistakes already made in real releases
|
||||
(store lists that lag after a create, dry runs without a plan, taken App Store names, byte limits, ...) and what to do.
|
||||
|
||||
1. **The owner presses only the owner steps** (point 2 of the first rule). Prepare them completely, say what will
|
||||
happen, and let the owner press the button, or run the command only after a clear yes in chat. storebound's MCP
|
||||
server does not offer these at all. Everything else you run yourself.
|
||||
2. **Dry run first, then run it yourself.** Every write command has `--dry` (MCP: `dry_run`, default true). Run the
|
||||
dry run, check and show it (the rows that change, not just a count), then run the real command yourself (`--yes`
|
||||
where it asks for a confirmation) and read the result back. Wait for the owner's yes only before an owner step.
|
||||
3. **Read before you write.** `storebound scan` (offline: rejection risks in the project itself), `storebound check`
|
||||
(offline) and `storebound validate` (read-only, both stores) tell you what is missing and in which order to fix it.
|
||||
4. **Credentials only from the environment, `.storebound/`** in the project (gitignored) **or a credential profile**
|
||||
(`~/.storebound/credentials/<profile>.json`, named by `--account <profile>` or a workspace). Never ask for keys,
|
||||
passwords or tokens in chat, never print them, never write them into the config, docs or commits. The same goes
|
||||
for the App Review demo account (`reviewDemoAccount` in `.storebound/credentials.json`): the owner puts it there.
|
||||
5. **Never answer a compliance question you cannot know.** Export compliance, Data safety, App Privacy, age rating,
|
||||
target audience: ask the owner when the code does not prove the answer. A wrong "no" is worse than a slow "ask".
|
||||
target audience: ask the owner when the code does not prove the answer, all such questions in one batch at the
|
||||
start (first rule, point 3), and write the answers into the config. A wrong "no" is worse than a slow "ask".
|
||||
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
||||
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
||||
you report the progress lines, not guesses.
|
||||
|
|
@ -30,43 +72,72 @@ These rules apply to every AI tool that uses storebound (skills, MCP server or t
|
|||
9. **Personal data stays local.** Tester lists, review reply drafts, health reports and analytics snapshots live in
|
||||
`.storebound/` (gitignored). Never put tester emails, reviewer names or crash logs into issues, docs or commits,
|
||||
and never ask for tester emails in chat (storebound masks them in its output).
|
||||
10. **Console forms without an API: drive them yourself, agent-first.** `storebound console plan <form> --json` (MCP
|
||||
`console_plan`) gives the start URL, steps, the answer sheet, the buttons you must never press and the verified UI
|
||||
facts. Drive the page with your own browser tool, adapt to what it shows, run long flows as an in-page async loop
|
||||
that writes `window.__log` (one evaluate call times out around 45 s), stop only before the final button (Publish,
|
||||
Submit, Create, a final Save) and tell the owner exactly what to press, then `storebound console verify <form>`.
|
||||
Never sign in, accept an agreement or grant a permission (a service account's app access) for the owner.
|
||||
`storebound console fill` is the optional scripted fast path; it never blocks you.
|
||||
11. **Console pages: always the absolute deep link.** When you send the owner to a console page, give the absolute
|
||||
deep link (storebound prints it; `storebound console plan` has start URLs), never just "go to App Store Connect"
|
||||
or "App Store Connect > App Information" alone.
|
||||
|
||||
## Tools
|
||||
|
||||
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||
- CLI: `storebound <command>` (`storebound help`; outside the plugin: `npx storebound` on Node 20+ or `bunx storebound` on Bun); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||
- MCP: `storebound mcp` (stdio). MCP 2026-07-28 + 2025-11-25. Write tools default to `dry_run: true`; submit / release / cancel / delete / send are not exposed.
|
||||
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||
- Readiness: `storebound scan` (offline rejection risks in the project files), `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||
- Every endpoint: `storebound api apple|play <operationId>` (skill store-api). GETs run; writes are dry unless the owner adds `--yes` in a terminal; MCP has the read-only `api_get`.
|
||||
|
||||
## Skills
|
||||
|
||||
- `skills/account-deletion/SKILL.md`: Make account deletion pass App Store and Google Play review for an app with sign-up or sign-in
|
||||
- `skills/adhoc-distribution/SKILL.md`: Get a test build of a mobile app or game onto specific devices without a store review
|
||||
- `skills/ads-levelplay-checks/SKILL.md`: Renamed to ads-mediation-checks (AdMob, AppLovin MAX and Unity LevelPlay / ironSource). Kept so existing installs and links keep working. Use ads-mediation-checks for any ad mediation, app-ads.txt, SKAdNetwork or "no fill" question
|
||||
- `skills/ads-mediation-checks/SKILL.md`: Diagnose and verify ad mediation in a mobile app or game before and after store release
|
||||
- `skills/app-icons/SKILL.md`: Generate every icon a mobile app or game needs from one artwork
|
||||
- `skills/app-previews/SKILL.md`: Make App Store app preview videos and a Google Play promo video for a mobile app or game from real footage (gameplay or app flows)
|
||||
- `skills/app-store-promotion/SKILL.md`: App Store promotion tools for a mobile app or game through the App Store Connect API
|
||||
- `skills/apple-ads/SKILL.md`: Read Apple Ads (formerly Apple Search Ads) results for a mobile app or game and make small, owner-approved bid, daily budget and pause changes
|
||||
- `skills/appstore-first-release/SKILL.md`: Step-by-step first (and later) App Store release of a mobile app or game
|
||||
- `skills/aso-basics/SKILL.md`: App store optimization basics for a mobile app's or game's text
|
||||
- `skills/build-and-sign/SKILL.md`: Sign, build and upload a mobile app or game from the terminal
|
||||
- `skills/console-autofill/SKILL.md`: Fill App Store Connect and Google Play Console forms that have no API (New App, App Privacy, Play Create app, IARC content rating, every Play App content card, Play Store settings category, first production release countries and send-for-review). Agent-first by default
|
||||
- `skills/export-compliance/SKILL.md`: Answer App Store export compliance (encryption) for a mobile app or game correctly
|
||||
- `skills/game-services/SKILL.md`: Set up Game Center (App Store) and Play Games Services (Google Play) for a mobile game from one config section
|
||||
- `skills/listing-localization/SKILL.md`: Translate the store listing of a mobile app or game into more languages
|
||||
- `skills/migrate-from-fastlane/SKILL.md`: Move a mobile app or game from fastlane (deliver, supply, snapshot / screengrab, Appfile, Deliverfile) to storebound with `storebound import fastlane`
|
||||
- `skills/play-first-release/SKILL.md`: Step-by-step first (and later) Google Play release of a mobile app or game
|
||||
- `skills/portfolio-originality/SKILL.md`: Originality gate for studios and developers that ship many similar mobile apps or games (templates, white-label apps, reskins)
|
||||
- `skills/ppp-pricing/SKILL.md`: Propose purchasing power parity (PPP) prices for a mobile app's or game's in-app products in every App Store territory and Google Play region with `storebound prices ppp`
|
||||
- `skills/privacy-manifest/SKILL.md`: Add and check Apple privacy manifests (PrivacyInfo.xcprivacy) for an iOS app or game
|
||||
- `skills/privacy-policy/SKILL.md`: Write and host one studio-wide privacy policy page for all of a developer's mobile apps and games
|
||||
- `skills/release-flows/SKILL.md`: Repo-local workflows for a mobile app or game
|
||||
- `skills/release-management/SKILL.md`: Ship updates safely after the first release
|
||||
- `skills/revenuecat-sync/SKILL.md`: Optional adapter that keeps a RevenueCat project's catalog in step with the storebound config
|
||||
- `skills/review-access/SKILL.md`: Give App Store and Google Play reviewers working access to an app behind a sign-in
|
||||
- `skills/review-rejections/SKILL.md`: Triage and answer an App Store or Google Play rejection, policy warning or strike for a mobile app or game
|
||||
- `skills/review-replies/SKILL.md`: Reply to App Store and Google Play reviews of a mobile app or game the safe way
|
||||
- `skills/store-analytics/SKILL.md`: Take store analytics snapshots for a mobile app or game (App Store impressions, product page views, downloads and conversion through the Analytics Reports API; Google Play store listing visitors, acquisitions and installs from the Play reports bucket) and compare them with listing, screenshot and experiment changes from git
|
||||
- `skills/store-analytics/SKILL.md`: Take store analytics snapshots for a mobile app or game (App Store impressions, product page views, downloads and conversion through the Analytics Reports API; Google Play store listing visitors, acquisitions and installs from the Play reports bucket) and compare them with listing, screenshot and experiment changes from git; download App Store sales / finance reports and Play earnings / sales reports with a summary per product and currency
|
||||
- `skills/store-api/SKILL.md`: Call any App Store Connect API or Google Play Developer API operation that storebound's commands do not wrap, safely
|
||||
- `skills/store-declarations/SKILL.md`: Answer the store compliance forms for a mobile app or game
|
||||
- `skills/store-health/SKILL.md`: Watch a released mobile app's or game's crash and ANR health on both stores
|
||||
- `skills/store-iap-setup/SKILL.md`: Create and price in-app purchases (consumables, non-consumables like "remove ads" or a Pro unlock, non-renewing passes, coin/gem packs, starter packs) on Google Play and App Store Connect from one product list
|
||||
- `skills/store-pitfalls/SKILL.md`: Known pitfalls with App Store Connect, Google Play and storebound itself, learned from real releases, and what to do about each
|
||||
- `skills/store-preflight/SKILL.md`: Run and read the storebound readiness checks before submitting a mobile app or game
|
||||
- `skills/store-screenshots/SKILL.md`: Produce store screenshots and the Play feature graphic for a mobile app or game in every required size and many languages
|
||||
- `skills/store-subscriptions/SKILL.md`: Set up auto-renewable subscriptions on the App Store and Google Play from one config
|
||||
- `skills/testflight/SKILL.md`: Run TestFlight for a mobile app or game through the App Store Connect API
|
||||
- `skills/web-presence/SKILL.md`: Set up the web side of a mobile app or game
|
||||
- `skills/whats-new/SKILL.md`: Write user-facing release notes ("What's new") for a mobile app or game update from the git log since the last tag
|
||||
|
||||
## Working on storebound itself
|
||||
|
||||
- Bun + TypeScript strict, zero runtime dependencies. `bun run ci` must pass (adapters fresh, tests, typecheck, scrub).
|
||||
- Inner loop: `bun run ci:quick` (typecheck, the tests related to your change against origin/main, scrub; seconds).
|
||||
Before every push: the full `bun run ci` (every check and test, in parallel shards), and check its exit code.
|
||||
- Skills are the single source: edit `skills/*/SKILL.md` or `docs/agents-core.md`, then `bun tools/gen-adapters.ts`.
|
||||
- Every check, rule, template line, message and desktop view covers both stores (App Store and Google Play) and every
|
||||
surface (CLI, MCP, desktop, skills); when a store has no equivalent field, say where the same thing goes there.
|
||||
- Never commit credentials, account / team / issuer / key / app ids or personal data; placeholders use example.com.
|
||||
|
|
|
|||
1837
CHANGELOG.md
|
|
@ -7,9 +7,38 @@ but fixes, store rule updates and new engines / AI tools are very welcome.
|
|||
|
||||
```sh
|
||||
bun install # Bun 1.1+; playwright is a dev dependency (renders, web capture)
|
||||
bun run ci # adapters fresh, tests, typecheck, secrets / personal data scrub
|
||||
bun run ci:quick # inner loop: typecheck + the tests your change touches + scrub (seconds)
|
||||
bun run ci # full gate before pushing: every check and test (adapters, API tables, typecheck,
|
||||
# desktop build, Rust host when it changed, scrub); no browser
|
||||
bun run test:browser # only by hand: the suites that start Chrome / Chromium (tests/browser/*.browser.ts)
|
||||
```
|
||||
|
||||
**Windows.** `.gitattributes` keeps every text file LF in the working tree (with `core.autocrlf=true` the skills
|
||||
came out CRLF and `bun tools/gen-adapters.ts` failed with "no frontmatter"). On a checkout made before that file
|
||||
existed, run `git rm -r --cached -q . && git reset --hard` once on a clean tree. The desktop app builds with
|
||||
`cd apps/desktop && bun run sidecar && bunx tauri build` (Rust via rustup; WiX and NSIS are downloaded by Tauri) into
|
||||
`src-tauri/target/release/bundle/nsis/*-setup.exe` and `bundle/msi/*.msi`.
|
||||
|
||||
**Browser tests run only by hand.** The suites that launch a browser (console fill / flow / session / persist, web
|
||||
capture, glyphs and ligatures, local fonts, feature-graphic fit, site overflow) live in `tests/browser/` as
|
||||
`*.browser.ts`, which `bun test`, `ci`, `ci:quick` and the Forgejo workflows never pick up. Run `bun run test:browser`
|
||||
when you change that code. The one browser step left in any automatic path is the desktop boot check inside
|
||||
`tools/desktop-release.ts mac` at release time: the built window must be seen rendering before a build ships.
|
||||
|
||||
**Which one when.** Run `bun run ci:quick` while you work: it diffs against `origin/main` (committed, staged,
|
||||
unstaged and new files), maps the changed files to the tests that import them (directly, through other modules, or
|
||||
by naming a fixture or page) and runs those, plus `tsc` (incremental) and the scrub. A change to `package.json`,
|
||||
`bun.lock`, `bunfig.toml`, `tsconfig.json` or the test preload runs every test. Run the full `bun run ci` before every
|
||||
push and check its exit code: it is the gate, `ci:quick` is not.
|
||||
|
||||
`tools/ci.ts` runs the steps as a task graph (independent steps at the same time, output prefixed with the step
|
||||
name, the first failure stops the rest, a time-per-step summary at the end). The tests run as parallel shards
|
||||
(CPU cores - 1, at most 8; `STOREBOUND_CI_SHARDS=n` overrides) balanced by the durations of the last run, kept in
|
||||
`node_modules/.cache/storebound-ci/`. So tests must be shard-safe: temp folders
|
||||
from `mkdtempSync`, servers on port 0, no fixed sleeps (wait for the event), no state shared through files in the
|
||||
checkout. The desktop Rust host (`cargo test`, `clippy`) runs only when `apps/desktop/src-tauri/` or
|
||||
`tools/build-sidecars.ts` changed against `origin/main` (Forgejo CI: against the pushed commit's parent).
|
||||
|
||||
Try the screenshot and video pipeline on the demo game without any store account: see
|
||||
[examples/demo-game/README.md](examples/demo-game/README.md).
|
||||
|
||||
|
|
@ -17,6 +46,12 @@ Try the screenshot and video pipeline on the demo game without any store account
|
|||
|
||||
- **Bun + TypeScript strict, zero runtime dependencies.** `fetch` against the official store APIs, `node:` built-ins,
|
||||
external tools (`ffmpeg`, `xcrun`, `adb`) only through argv builders. Playwright is resolved from the user's project.
|
||||
- **Runs on Node 20+ and Bun.** Development, tests and CI use Bun; users run the npm bundle with Node (`npx`) or Bun
|
||||
(`bunx`). The CLI never touches the `Bun` global, `bun:` modules, `import.meta.dir` or text imports: everything goes
|
||||
through `cli/lib/rt.ts` (spawn, which, sleep, serve, glob, hashing, stdin, the package folder, config imports), and
|
||||
text files the CLI ships are embedded by `bun tools/gen-embedded.ts` (templates/, `cli/shots/*.html`, Play's form
|
||||
export: run it after changing one). `tests/node-compat.test.ts` fails on a direct Bun use; `bun run ci` builds the
|
||||
bundle (`tools/build-node.ts`) and runs it with the real `node` (`tools/node-smoke.ts`).
|
||||
- **Pure where possible.** Rules, argv builders, plans and parsers are pure functions with tests in `tests/`; the IO
|
||||
stays in the command's `run`. Tests never need a store account, a simulator or a network.
|
||||
- **Every write command takes `--dry`** and is idempotent. New MCP write tools default to `dry_run: true`. Nothing
|
||||
|
|
@ -27,10 +62,39 @@ Try the screenshot and video pipeline on the demo game without any store account
|
|||
- **Skills are the single source.** Edit `skills/*/SKILL.md` or `docs/agents-core.md`, then run
|
||||
`bun tools/gen-adapters.ts`; never edit `AGENTS.md`, `GEMINI.md`, the plugin manifests or the Cursor / Copilot files
|
||||
by hand. Frontmatter is `name` + `description` only.
|
||||
- **New or renamed flags: run `bun tools/gen-flags.ts`.** The CLI rejects a flag a command does not read
|
||||
(`cli/data/flags.json`, generated from the commands and their imports in `cli/commands.ts`); a flag read with a
|
||||
computed name goes into `DYNAMIC` in that tool. `tests/cli-help.test.ts` fails on a stale table, on a command whose
|
||||
`--help` does anything but print its usage, and on an MCP / desktop tool that passes a flag its command does not take.
|
||||
- **No secrets, no real ids, no personal data** in code, tests, fixtures or examples: use `com.example.*`,
|
||||
`example.com` and obviously fake values. `bun run ci` runs the scrub.
|
||||
- **No hand-written SVG.** Charts come from visx, icons from Phosphor (`@phosphor-icons/react` in the desktop app, one
|
||||
per-icon import each; the site's icons are Phosphor's own files from `@phosphor-icons/core`), the App Store and
|
||||
Google Play marks from simple-icons (vendored with the licences by `bun tools/site-icons.ts` into `site/img/icons/`
|
||||
and `apps/desktop/src/ui/store-marks/`, byte-equal to the packages),
|
||||
diagrams from Mermaid (`docs/diagrams/*.mmd`, rendered by `bun tools/diagrams.ts`), the desktop fixtures' art from
|
||||
`bun tools/fixture-art.ts`. The logo files (app icons, favicons, header marks, `site/og.png`) are PNG / ICO / ICNS from
|
||||
`tools/brand-assets.py` (`brand/README.md`). `tests/no-handmade-svg.test.ts`
|
||||
fails on new inline `<svg>` / `<path>` drawing in `apps/desktop/src` and `site/*.html` and on SVG files that are
|
||||
not vendored or rendered. These libraries are desktop
|
||||
dependencies (bundled by Vite) or devDependencies; the CLI package keeps zero runtime dependencies.
|
||||
- **Every bug found in real use becomes a guardrail.** Add an entry to `docs/pitfalls.md` and to
|
||||
`skills/store-pitfalls/SKILL.md` (symptom, cause, what to do, what guards it) and, where possible, a check or a test
|
||||
with recorded store answers that fails without the fix. A `--dry` run prints the plan (`dryPlan` in
|
||||
`cli/lib/dry.ts`), not only a count; `tests/pitfalls.test.ts` enforces it.
|
||||
- Plain English in docs and messages, short sentences, no marketing words.
|
||||
|
||||
## Releasing the npm package
|
||||
|
||||
`npm pack` and `npm publish` run `prepack`, which builds `dist/storebound.mjs` (the `bin`, `#!/usr/bin/env node`,
|
||||
gitignored) with `bun tools/build-node.ts`. Before publishing: `bun run ci` green (it smoke-tests the bundle with
|
||||
Node), `npm pack --dry-run` lists `dist/storebound.mjs`, the privacy scan on the tree and on the bundle, and a run of
|
||||
the packed tarball in an empty folder (`npx --yes ./storebound-<version>.tgz --version`, then `init`).
|
||||
|
||||
The npm package and the desktop app are one release with one version (`bun tools/desktop-version.ts --set <version>`
|
||||
writes it everywhere): publish the desktop artifacts of that version first (docs/desktop-release.md), then
|
||||
`npm publish`, so `npx storebound desktop` of the new CLI finds its own app.
|
||||
|
||||
## Pull requests
|
||||
|
||||
One topic per PR, `bun run ci` green, a line in `CHANGELOG.md` under an "Unreleased" heading, and for anything
|
||||
|
|
|
|||
95
GEMINI.md
|
|
@ -6,20 +6,62 @@ This extension ships Agent Skills (skills/) and the storebound MCP server for mo
|
|||
|
||||
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
||||
|
||||
1. **The owner decides public and irreversible steps.** Submitting for review (App Review or Beta App Review),
|
||||
releasing a version, resuming or completing a rollout, canceling a submission, deleting products or listings,
|
||||
accepting agreements, sending review replies, inviting or removing testers, changing prices, starting or stopping
|
||||
a store experiment: explain what will happen and let the owner do it (or run the command only after a clear yes in
|
||||
chat). storebound's MCP server does not offer these at all.
|
||||
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
||||
for real only after the owner agrees.
|
||||
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
||||
what is missing and in which order to fix it.
|
||||
4. **Credentials only from the environment or `.storebound/`** in the project (gitignored). Never ask for keys,
|
||||
## First rule: do it, don't ask
|
||||
|
||||
storebound plus you, the AI agent, do the work. The owner is not your pair of hands.
|
||||
|
||||
1. **You do everything yourself:** API calls, uploads, builds, template and CSV downloads and exports, every console
|
||||
navigation (open, Get Started, Edit, Next, Continue, Save draft), console forms, and the verification afterwards.
|
||||
Never tell the owner "run this yourself" or "click X yourself" for any of these.
|
||||
2. **The owner keeps only the final public or irreversible buttons:** Submit for review (App Review or Beta App
|
||||
Review), releasing a version or completing / resuming a production rollout, App Privacy Publish, accepting legal
|
||||
agreements; plus deleting store data, changing live prices, sending review replies and inviting or removing
|
||||
testers. (Also the owner's: canceling a submission, starting or stopping a store experiment, a console form's final
|
||||
Submit / Create that a console plan lists in `buttons.final`, signing in and granting account permissions.) For
|
||||
these you prepare everything, show the dry run, and the owner presses one button or says yes.
|
||||
**Updates are agent steps:** a new version of an app that is already on the store (Play: the production track holds
|
||||
a published release; App Store: a version of the platform is or was on sale) is yours end to end, no owner gate
|
||||
per update: `storebound play release <aab> --production completed --yes`, `storebound play upload --track
|
||||
production --yes`, `storebound apple submit --build <n> --yes`, `storebound apple release --manual-release --yes`
|
||||
(docs/bypass.md). Only the **first-ever release** of an app stays the owner's (exit 3 `OWNER_STEP`: after the
|
||||
owner's yes re-run with `--first-release`), plus removal from sale, live price changes and anything that costs money.
|
||||
**Bypass mode** (`storebound settings bypass status`): when the owner turned it on, you run these owner steps too:
|
||||
MCP `owner_step` (dry run first, then `dry_run: false`), `storebound api ... --yes --confirm <operationId>`, and
|
||||
console plans' `buttons.final`. Say in one line what you pressed; every action is logged to
|
||||
`.storebound/owner-actions.log`. Legal agreements, passwords and 2FA stay with the owner if your own rules say so.
|
||||
3. **Ask the owner only for facts that no code, config or doc can prove:** compliance answers such as Data safety,
|
||||
App Privacy, age rating, export compliance, partial data deletion. Collect ALL of them in ONE batch at the start
|
||||
(`storebound check` and `storebound validate` list them), never one at a time during the run. Reuse answers that
|
||||
are already in the config.
|
||||
4. **Default loop:** plan, then you drive (the API first, your browser tool for consoles without an API), then verify
|
||||
(read it back), then continue. No round trip to the owner in between.
|
||||
5. **Catch rejections offline.** Before a write, `storebound check` and `--dry` must catch what the store would refuse
|
||||
(live-shape fixtures, id and pair checks). A failure belongs in the dry run, not in a 400 at write time; when a
|
||||
store refuses something the dry run passed, fix the check (pitfalls), not just the data.
|
||||
|
||||
Every hour of "please click this" is an hour the owner did not want to spend. If you catch yourself writing "you
|
||||
need to ...", do it instead, unless it is one of the owner steps in point 2.
|
||||
|
||||
## The other rules
|
||||
|
||||
**Read `skills/store-pitfalls/SKILL.md` before any store task.** It lists the mistakes already made in real releases
|
||||
(store lists that lag after a create, dry runs without a plan, taken App Store names, byte limits, ...) and what to do.
|
||||
|
||||
1. **The owner presses only the owner steps** (point 2 of the first rule). Prepare them completely, say what will
|
||||
happen, and let the owner press the button, or run the command only after a clear yes in chat. storebound's MCP
|
||||
server does not offer these at all. Everything else you run yourself.
|
||||
2. **Dry run first, then run it yourself.** Every write command has `--dry` (MCP: `dry_run`, default true). Run the
|
||||
dry run, check and show it (the rows that change, not just a count), then run the real command yourself (`--yes`
|
||||
where it asks for a confirmation) and read the result back. Wait for the owner's yes only before an owner step.
|
||||
3. **Read before you write.** `storebound scan` (offline: rejection risks in the project itself), `storebound check`
|
||||
(offline) and `storebound validate` (read-only, both stores) tell you what is missing and in which order to fix it.
|
||||
4. **Credentials only from the environment, `.storebound/`** in the project (gitignored) **or a credential profile**
|
||||
(`~/.storebound/credentials/<profile>.json`, named by `--account <profile>` or a workspace). Never ask for keys,
|
||||
passwords or tokens in chat, never print them, never write them into the config, docs or commits. The same goes
|
||||
for the App Review demo account (`reviewDemoAccount` in `.storebound/credentials.json`): the owner puts it there.
|
||||
5. **Never answer a compliance question you cannot know.** Export compliance, Data safety, App Privacy, age rating,
|
||||
target audience: ask the owner when the code does not prove the answer. A wrong "no" is worse than a slow "ask".
|
||||
target audience: ask the owner when the code does not prove the answer, all such questions in one batch at the
|
||||
start (first rule, point 3), and write the answers into the config. A wrong "no" is worse than a slow "ask".
|
||||
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
||||
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
||||
you report the progress lines, not guesses.
|
||||
|
|
@ -28,39 +70,64 @@ These rules apply to every AI tool that uses storebound (skills, MCP server or t
|
|||
9. **Personal data stays local.** Tester lists, review reply drafts, health reports and analytics snapshots live in
|
||||
`.storebound/` (gitignored). Never put tester emails, reviewer names or crash logs into issues, docs or commits,
|
||||
and never ask for tester emails in chat (storebound masks them in its output).
|
||||
10. **Console forms without an API: drive them yourself, agent-first.** `storebound console plan <form> --json` (MCP
|
||||
`console_plan`) gives the start URL, steps, the answer sheet, the buttons you must never press and the verified UI
|
||||
facts. Drive the page with your own browser tool, adapt to what it shows, run long flows as an in-page async loop
|
||||
that writes `window.__log` (one evaluate call times out around 45 s), stop only before the final button (Publish,
|
||||
Submit, Create, a final Save) and tell the owner exactly what to press, then `storebound console verify <form>`.
|
||||
Never sign in, accept an agreement or grant a permission (a service account's app access) for the owner.
|
||||
`storebound console fill` is the optional scripted fast path; it never blocks you.
|
||||
11. **Console pages: always the absolute deep link.** When you send the owner to a console page, give the absolute
|
||||
deep link (storebound prints it; `storebound console plan` has start URLs), never just "go to App Store Connect"
|
||||
or "App Store Connect > App Information" alone.
|
||||
|
||||
## Tools
|
||||
|
||||
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||
- CLI: `storebound <command>` (`storebound help`; outside the plugin: `npx storebound` on Node 20+ or `bunx storebound` on Bun); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||
- MCP: `storebound mcp` (stdio). MCP 2026-07-28 + 2025-11-25. Write tools default to `dry_run: true`; submit / release / cancel / delete / send are not exposed.
|
||||
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||
- Readiness: `storebound scan` (offline rejection risks in the project files), `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||
- Every endpoint: `storebound api apple|play <operationId>` (skill store-api). GETs run; writes are dry unless the owner adds `--yes` in a terminal; MCP has the read-only `api_get`.
|
||||
|
||||
## Skills
|
||||
|
||||
| skill | for |
|
||||
|---|---|
|
||||
| `account-deletion` | Make account deletion pass App Store and Google Play review for an app with sign-up or sign-in |
|
||||
| `adhoc-distribution` | Get a test build of a mobile app or game onto specific devices without a store review |
|
||||
| `ads-levelplay-checks` | Renamed to ads-mediation-checks (AdMob, AppLovin MAX and Unity LevelPlay / ironSource). Kept so existing installs and links keep working. Use ads-mediation-checks for any ad mediation, app-ads.txt, SKAdNetwork or "no fill" question |
|
||||
| `ads-mediation-checks` | Diagnose and verify ad mediation in a mobile app or game before and after store release |
|
||||
| `app-icons` | Generate every icon a mobile app or game needs from one artwork |
|
||||
| `app-previews` | Make App Store app preview videos and a Google Play promo video for a mobile app or game from real footage (gameplay or app flows) |
|
||||
| `app-store-promotion` | App Store promotion tools for a mobile app or game through the App Store Connect API |
|
||||
| `apple-ads` | Read Apple Ads (formerly Apple Search Ads) results for a mobile app or game and make small, owner-approved bid, daily budget and pause changes |
|
||||
| `appstore-first-release` | Step-by-step first (and later) App Store release of a mobile app or game |
|
||||
| `aso-basics` | App store optimization basics for a mobile app's or game's text |
|
||||
| `build-and-sign` | Sign, build and upload a mobile app or game from the terminal |
|
||||
| `console-autofill` | Fill App Store Connect and Google Play Console forms that have no API (New App, App Privacy, Play Create app, IARC content rating, every Play App content card, Play Store settings category, first production release countries and send-for-review). Agent-first by default |
|
||||
| `export-compliance` | Answer App Store export compliance (encryption) for a mobile app or game correctly |
|
||||
| `game-services` | Set up Game Center (App Store) and Play Games Services (Google Play) for a mobile game from one config section |
|
||||
| `listing-localization` | Translate the store listing of a mobile app or game into more languages |
|
||||
| `migrate-from-fastlane` | Move a mobile app or game from fastlane (deliver, supply, snapshot / screengrab, Appfile, Deliverfile) to storebound with `storebound import fastlane` |
|
||||
| `play-first-release` | Step-by-step first (and later) Google Play release of a mobile app or game |
|
||||
| `portfolio-originality` | Originality gate for studios and developers that ship many similar mobile apps or games (templates, white-label apps, reskins) |
|
||||
| `ppp-pricing` | Propose purchasing power parity (PPP) prices for a mobile app's or game's in-app products in every App Store territory and Google Play region with `storebound prices ppp` |
|
||||
| `privacy-manifest` | Add and check Apple privacy manifests (PrivacyInfo.xcprivacy) for an iOS app or game |
|
||||
| `privacy-policy` | Write and host one studio-wide privacy policy page for all of a developer's mobile apps and games |
|
||||
| `release-flows` | Repo-local workflows for a mobile app or game |
|
||||
| `release-management` | Ship updates safely after the first release |
|
||||
| `revenuecat-sync` | Optional adapter that keeps a RevenueCat project's catalog in step with the storebound config |
|
||||
| `review-access` | Give App Store and Google Play reviewers working access to an app behind a sign-in |
|
||||
| `review-rejections` | Triage and answer an App Store or Google Play rejection, policy warning or strike for a mobile app or game |
|
||||
| `review-replies` | Reply to App Store and Google Play reviews of a mobile app or game the safe way |
|
||||
| `store-analytics` | Take store analytics snapshots for a mobile app or game (App Store impressions, product page views, downloads and conversion through the Analytics Reports API; Google Play store listing visitors, acquisitions and installs from the Play reports bucket) and compare them with listing, screenshot and experiment changes from git |
|
||||
| `store-analytics` | Take store analytics snapshots for a mobile app or game (App Store impressions, product page views, downloads and conversion through the Analytics Reports API; Google Play store listing visitors, acquisitions and installs from the Play reports bucket) and compare them with listing, screenshot and experiment changes from git; download App Store sales / finance reports and Play earnings / sales reports with a summary per product and currency |
|
||||
| `store-api` | Call any App Store Connect API or Google Play Developer API operation that storebound's commands do not wrap, safely |
|
||||
| `store-declarations` | Answer the store compliance forms for a mobile app or game |
|
||||
| `store-health` | Watch a released mobile app's or game's crash and ANR health on both stores |
|
||||
| `store-iap-setup` | Create and price in-app purchases (consumables, non-consumables like "remove ads" or a Pro unlock, non-renewing passes, coin/gem packs, starter packs) on Google Play and App Store Connect from one product list |
|
||||
| `store-pitfalls` | Known pitfalls with App Store Connect, Google Play and storebound itself, learned from real releases, and what to do about each |
|
||||
| `store-preflight` | Run and read the storebound readiness checks before submitting a mobile app or game |
|
||||
| `store-screenshots` | Produce store screenshots and the Play feature graphic for a mobile app or game in every required size and many languages |
|
||||
| `store-subscriptions` | Set up auto-renewable subscriptions on the App Store and Google Play from one config |
|
||||
| `testflight` | Run TestFlight for a mobile app or game through the App Store Connect API |
|
||||
| `web-presence` | Set up the web side of a mobile app or game |
|
||||
| `whats-new` | Write user-facing release notes ("What's new") for a mobile app or game update from the git log since the last tag |
|
||||
|
|
|
|||
591
README.md
|
|
@ -1,533 +1,118 @@
|
|||
<p><img src="https://git.crt.fyi/CRT/storebound/raw/branch/main/brand/logo-mark-256.png" width="96" height="96" alt="storebound logo"></p>
|
||||
|
||||
# storebound
|
||||
|
||||
**Website: [storebound.dev](https://storebound.dev)**
|
||||
**From an empty folder to "Submit for review" on Google Play and the App Store.**
|
||||
|
||||
[](LICENSE)
|
||||
[](CHANGELOG.md)
|
||||
[](https://bun.sh)
|
||||
[](package.json)
|
||||
[](skills)
|
||||
[](#mcp-server)
|
||||
Your AI agent does all of it with storebound: builds, uploads, store text, screenshots in every language and size,
|
||||
in-app products and prices, the compliance forms, even the consoles that have no API. You only press Submit.
|
||||
|
||||
**Take a mobile app or game from nothing to "Submit for review" on Google Play and the App Store: app records,
|
||||
listings in every language, in-app products and subscriptions with regional prices, every questionnaire, account
|
||||
deletion and review access, privacy, icons, screenshots and previews, with one config and your AI coding agent.**
|
||||
[](https://www.npmjs.com/package/storebound)
|
||||
[](https://git.crt.fyi/CRT/storebound/src/branch/main/LICENSE)
|
||||
[](#install-and-start)
|
||||
[](https://git.crt.fyi/CRT/storebound/src/branch/main/package.json)
|
||||
[](https://git.crt.fyi/CRT/storebound/src/branch/main/skills)
|
||||
[](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/mcp.md)
|
||||
|
||||
Hey, I'm CRTkafa. I built this while getting my own game through both stores and hit every wall on the way: draft
|
||||
apps, edits that die when you touch the Console, the "first IAP must ship with a version" dance, Data safety CSVs that
|
||||
silently need one more answer, an IARC questionnaire, target audience, App Privacy labels that are saved but not
|
||||
published, screenshots in 7 sizes x 14 languages... I wrote each fix down as code or as a checklist. None of those
|
||||
walls is game-only: a to-do app with accounts and a subscription hits the same ones, plus a few of its own (a demo
|
||||
account for the reviewer, account deletion, subscription disclosures), so storebound covers apps and games alike. It
|
||||
works for me, so I open-sourced it. Use it too.
|
||||
**Website: [storebound.dev](https://storebound.dev) · Docs: [docs/](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/README.md) · `npx storebound init`**
|
||||
|
||||
No account, no sign-up, no telemetry. A small Bun CLI that talks to the official store APIs,
|
||||
Agent Skills that walk your AI coding tool (or you) through the parts that are still console clicks, and an MCP server
|
||||
so agents can call the CLI safely. **storebound never presses Submit, Release or Publish for you.**
|
||||
[](https://storebound.dev/#teaser)
|
||||
|
||||
Pick a profile and start from honest templates: `init --profile app` (utility / productivity app, optional account,
|
||||
analytics, no ads; the default), `--profile subscription-app` (accounts + auto-renewable subscriptions) or
|
||||
`--profile game` (free-to-play with ads and IAP).
|
||||
<sub>Watch the teaser on [storebound.dev](https://storebound.dev/#teaser): the demo game from an empty folder to both stores, then the desktop app.</sub>
|
||||
|
||||
It keeps going after launch: TestFlight groups and testers, crash and ANR vitals against the store thresholds, review
|
||||
replies you approve before they go out, prices for many products and regions from one CSV, store analytics next to
|
||||
your listing changes, and App Store product page tests from your screenshot variants.
|
||||
## Your agent does the whole job
|
||||
|
||||

|
||||
**Do it, don't ask.** You ask once ("get my app ready for both stores"); your agent and storebound do the work:
|
||||
the app records, builds and uploads, listings in every language, screenshots and previews in every store size, icons,
|
||||
in-app products and subscriptions priced in 175 countries, Data safety, App Privacy, age rating and every other form,
|
||||
and the console pages that have no API (the agent drives them from a `console plan`). Each step is planned first:
|
||||
|
||||
## The journey
|
||||

|
||||
|
||||
Everything an app or game needs before review, in the order I do it. For each step: what storebound does through the store
|
||||
APIs (or on your machine), what the skill walks your agent through where the stores have no public API, and what stays
|
||||
your own click.
|
||||
You press only the final public or irreversible buttons (Submit for review, releasing, App Privacy Publish, legal
|
||||
agreements) and answer, once and in one batch, the facts no file can prove. The full rules: [AGENTS.md](https://git.crt.fyi/CRT/storebound/src/branch/main/AGENTS.md);
|
||||
the whole journey step by step: [docs/journey.md](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/journey.md).
|
||||
|
||||
- **storebound**: a CLI command (also an MCP tool). Every write has `--dry`; MCP write tools default to a dry run.
|
||||
- **skill + agent (UI)**: no public API exists for it. The named skill has the exact navigation and the prepared
|
||||
answers. An agent with browser tools (a Chrome extension, computer use, a Playwright MCP ...) can click through it
|
||||
while you watch; without one, you click with the skill as your checklist.
|
||||
- **you**: public, legal or money steps. The skills tell every agent to stop and hand these to you.
|
||||
## You won't get rejected for the avoidable things
|
||||
|
||||
| # | step | storebound (API / local) | skill + agent (UI) | you |
|
||||
|---|---|---|---|---|
|
||||
| 1 | **Set up** | `init --profile app\|game\|subscription-app` (config, `store/*.md`, declarations, App Privacy and privacy templates per profile), `install --agent <tool>`, `check` | Play: service account + API access invite; App Store: API team key (`play-first-release`, `appstore-first-release`) | developer accounts; Paid Applications agreement, banking and tax; Play payments profile |
|
||||
| 2 | **App records and bundle id** | `apple bundle` registers the bundle id, `apple status` finds the app record | App Store Connect > New App (no API); Play Console > Create app; the very first AAB upload when Play needs it from the Console | the declarations you accept when creating the Play app |
|
||||
| 3 | **Builds and testers** | `play next-version-code`, `play release app.aab` (internal track), `apple next-build`, `xcodebuild` archive + upload with the API key (the skill has the commands), `apple encryption`, `apple testflight groups / what-to-test / info / distribute` (internal groups) | Play internal testers list, Apple sandbox testers (`play-first-release`, `testflight`) | `apple testflight testers` (Apple emails the invitations), external groups and Beta App Review (`distribute --submit-review`) |
|
||||
| 4 | **In-app products and subscriptions** | `play products` (regional prices from USD + your overrides, activated), `apple iap` (consumable, non-consumable, non-renewing; localizations, price schedule, availability), `apple iap-review`, `apple subscriptions` (groups, levels, equalized prices, intro and promotional offers, offer codes), `play subscriptions` (base plans, regional prices, offers), `catalog diff` (both stores against one catalog) | Play license testers, Apple sandbox testers, "Add for Review" of the first IAPs and subscriptions into the version's submission, Play promo codes (`store-iap-setup`, `store-subscriptions`) | custom offer codes (`apple subscriptions --codes` asks first) |
|
||||
| 5 | **Store listings, every language** | `play listing` (title, short / full description, contact email + website, promo video URL), `apple listing --version x --build N` (name, subtitle, description, keywords, promo text, URLs, privacy URL, manual release), `whats-new`, `check` (limits), `check --aso` | Play store settings: category and tags (`play-first-release`) | |
|
||||
| 6 | **Play questionnaires** | `play data-safety`: the whole Data safety form from `dataSafety` in the config (CSV import through the API) | Policy and programs > App content, answers prepared in `store/declarations.md` (`store-declarations`): privacy policy, app access with the demo account (`review-access`), delete-account URL (`account-deletion`), ads, content rating (IARC), target audience and content, advertising ID, news, government, financial and health features; Data safety summary check | the answers themselves are your statements: the agent asks when the code does not prove them |
|
||||
| 7 | **App Store questionnaires** | `apple appinfo` (categories, age rating declaration, content rights, Free price, availability), `apple encryption` (export compliance from `apple.usesNonExemptEncryption`, never guessed), `apple review-details` (contact, demo account from `.storebound/`, notes) | App Privacy nutrition labels from `store/app-privacy.md`, then **Publish** (`store-declarations`); encryption documentation when the answer is yes (`export-compliance`); the first availability record if the API refuses it | the export compliance answer (a legal statement, set once in the config) |
|
||||
| 8 | **Privacy and accounts** | privacy policy page template (`init`), `privacy-manifest --ios <path>` (PrivacyInfo.xcprivacy, required-reason APIs, SDK manifests), `validate` checks the policy, delete-account and terms URLs answer | host the pages, link them in both consoles and inside the app; in-app account deletion (`privacy-policy`, `privacy-manifest`, `account-deletion`) | |
|
||||
| 9 | **Icons** | `icons`: App Store 1024 without alpha, Play 512, adaptive + legacy Android launcher icons, web icons, Capacitor sources | | |
|
||||
| 10 | **Screenshots and previews** | `shots capture / render / check / gallery`, `play images`, `apple screenshots`, `shots record / video`, `apple previews`, `apple ppo create / upload` (App Store product page tests from `shots` variants; see [Store art](#store-art)) | Play store listing experiments (optional, `store-screenshots`) | uploading the promo video to YouTube; `apple ppo start / stop` |
|
||||
| 11 | **Validate** | `check` (offline) and `validate` (read-only on both stores: every blocker in fix order, plus the local renders) | the UI-only items `validate` cannot see (`store-preflight` lists them) | |
|
||||
| 12 | **Submit** | `play release --version-code N --production draft`, `apple status` | Play: countries / regions, open the production draft and save it (`play-first-release`) | **Play: Send changes for review. App Store: Submit for Review.** |
|
||||
| 13 | **After review** | `apple status --wait-review`, `apple release --phased on / pause`, `play rollout --halt`, reply drafts (`review-rejections`) | | releasing the approved version, resuming or completing a phased release or rollout (terminal commands that ask first, `release-management`) |
|
||||
| 14 | **Live app** | `health [--weekly]` (crash / ANR vitals vs Play's thresholds, App Store diagnostics; also in `validate`), `reviews list / draft`, `analytics snapshot / compare`, `prices export`, `prices import --dry`, `apple ppo status` | `store-health`, `review-replies`, `store-analytics`; Play statistics come from the reports bucket (no API) | `reviews send` (approved drafts only), `prices import` (asks first) |
|
||||
`storebound scan` reads your project (Xcode and Gradle files, manifests, lockfiles, SDKs, your listings) and the store
|
||||
state, and names every App Review or Play policy problem it can prove before the stores do: the guideline, the
|
||||
evidence as `file:line`, and the fix.
|
||||
|
||||
New personal Play developer accounts also need a closed test with 12+ testers for 14 days before production; the
|
||||
`play-first-release` skill covers it.
|
||||

|
||||
|
||||
### API or console, honestly
|
||||
Every rule, what it proves and what only a reviewer can see: [docs/rejections.md](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/rejections.md).
|
||||
|
||||
- **Through the API** (storebound does it): bundle id, builds on tracks, versions and build selection, listings in
|
||||
every language, graphics, screenshots, app previews, in-app products and prices (also from one CSV), Play Data
|
||||
safety, Apple age rating, categories, content rights, price and availability, export compliance answer, App Review
|
||||
details with the demo account, subscriptions (Apple groups, levels, prices, introductory and promotional offers,
|
||||
offer codes; Play base plans, regional prices, offers), phased release and staged rollout, TestFlight groups / testers / What to Test / Test Information, crash and
|
||||
ANR vitals and App Store diagnostics, review replies, App Store analytics reports, App Store Product Page
|
||||
Optimization tests.
|
||||
- **Console only** (no public API; the skill + your agent's browser, or you): creating the App Store Connect app record
|
||||
and the Play app, Play App content (IARC content rating, target audience, ads, advertising ID, app access,
|
||||
government / financial / health / news, app access with the demo account), Play category and tags, Play countries,
|
||||
App Privacy labels and their Publish, adding first IAPs and subscriptions to the submission, Play promo codes, Play store listing experiments, test results of both stores' experiments.
|
||||
Play store statistics have no API either: storebound reads the monthly exports from your Play reports bucket.
|
||||
- **Only you**: agreements, banking and tax, and the final Send for review / Submit for Review. Releases and
|
||||
rollouts after approval, Beta App Review, tester invitations, sending review replies, applying price changes and
|
||||
starting / stopping a product page test too. None of these is an MCP tool; the terminal commands ask first.
|
||||
## The desktop app: every app, both stores, one window
|
||||
|
||||
## 5-minute quick start
|
||||
Every app and game you ship on Google Play and the App Store side by side: releases, charts, catalog and prices,
|
||||
crash health, reviews, TestFlight and the rejection checks. Send for review from there too: a dry run first, then a
|
||||
confirm, then your click. Same storebound underneath, same version number as the CLI, and the same store accounts
|
||||
and app folders as your terminal (`~/.storebound`).
|
||||
|
||||
You need [Bun](https://bun.sh) 1.1+ (and `ffmpeg` for icons, screenshots and video).
|
||||

|
||||
|
||||
<details>
|
||||
<summary>More screens: portfolio, growth charts, prices, checks, TestFlight, console plan</summary>
|
||||
|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||
|
||||
</details>
|
||||
|
||||
`npx storebound desktop` installs it for you (macOS, Windows, Linux; signature checked, no admin rights) and opens it on
|
||||
the current app folder. Manual downloads: [storebound.dev/#download](https://storebound.dev/#download). Internals: [docs/desktop.md](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/desktop.md).
|
||||
|
||||
## Works with your AI, safe by design
|
||||
|
||||
Skills, an MCP server and the CLI for Claude Code, Codex, Cursor, Gemini CLI, Copilot, Windsurf, OpenCode or
|
||||
anything that reads `AGENTS.md`. Every write shows a dry run first; submit, release and delete are not MCP tools; keys
|
||||
stay in env vars or the gitignored `.storebound/`.
|
||||
|
||||

|
||||
|
||||
Per-tool setup: [docs/getting-started.md](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/getting-started.md#install-for-your-ai-tool) · MCP tools:
|
||||
[docs/mcp.md](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/mcp.md) · Safety model: [docs/safety.md](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/safety.md).
|
||||
|
||||
## Install and start
|
||||
|
||||
You need [Node](https://nodejs.org) 20+ or [Bun](https://bun.sh) 1.1+ (and `ffmpeg` for icons, screenshots and video).
|
||||
|
||||
```sh
|
||||
cd my-app
|
||||
bun add -d storebound playwright # or: bun add -d git+https://git.crt.fyi/CRT/storebound.git playwright
|
||||
bunx storebound init # --profile app (default) | subscription-app | game: config, store/*.md, declarations, privacy policy, .storebound/ (gitignored)
|
||||
# fill in storebound.config.ts and the store/ files
|
||||
bunx storebound check # offline: config, copy limits, Data safety answers, products, files
|
||||
npx storebound init # storebound.config.ts + .storebound/ in this project (--profile app | subscription-app | game)
|
||||
npx storebound desktop # installs the desktop app once (asks first) and opens it on this folder
|
||||
```
|
||||
|
||||
Add credentials (below), then walk the journey with dry runs first:
|
||||
One product, installed once per machine: the CLI (`npx` / `bunx`) and the desktop app have the same version, the same
|
||||
store accounts (`~/.storebound/credentials`, `npx storebound accounts`) and the same list of app folders. Each project
|
||||
has its `storebound.config.ts` and a gitignored `.storebound/` (upload keystore, review contact). Then
|
||||
`npx storebound install --agent claude` (or codex, cursor, gemini, copilot, windsurf, opencode) and
|
||||
`npx storebound check`. Every `npx storebound ...` works as `bunx storebound ...` too.
|
||||
|
||||
```sh
|
||||
bunx storebound apple bundle --dry
|
||||
bunx storebound play listing --dry
|
||||
bunx storebound play products --dry && bunx storebound apple iap --dry
|
||||
bunx storebound apple subscriptions --dry && bunx storebound play subscriptions --dry
|
||||
bunx storebound apple review-details --dry # contact + demo account from .storebound/ (masked) + notes
|
||||
bunx storebound play data-safety --dry --csv store/data-safety.csv
|
||||
bunx storebound apple appinfo --dry
|
||||
bunx storebound icons --dry
|
||||
bunx storebound shots capture && bunx storebound shots render && bunx storebound shots gallery
|
||||
bunx storebound validate # read-only: what still blocks a submission, per store, in fix order
|
||||
bunx storebound catalog diff # read-only: products + subscriptions on both stores vs the config, prices per region
|
||||
```
|
||||
Then ask your agent: "take my app to Google Play and the App Store". Claude Code plugin, credentials, coming from
|
||||
fastlane: [docs/getting-started.md](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/getting-started.md).
|
||||
|
||||
After launch:
|
||||
## What it covers
|
||||
|
||||
```sh
|
||||
bunx storebound apple testflight what-to-test --build 42 --dry # then distribute --build 42 --group Team
|
||||
bunx storebound health --weekly # vitals + diagnostics, .storebound/health/<date>.md
|
||||
bunx storebound reviews draft # reply drafts in .storebound/replies/, then reviews send
|
||||
bunx storebound prices export && bunx storebound prices import --dry
|
||||
bunx storebound analytics snapshot && bunx storebound analytics compare
|
||||
```
|
||||
Store screenshots of the demo game, rendered by storebound in every size and language:
|
||||
|
||||
Or ask your agent: "take my app to Google Play and the App Store", "fill in the store questionnaires", "set up the
|
||||
in-app purchases and a yearly subscription with a free trial on both stores", "do both stores sell the same
|
||||
catalog", "the reviewer could not sign in", "make store screenshots in 5 languages", "is my app ready to submit", "why was my
|
||||
update rejected", "put build 42 on TestFlight", "how are our crash rates", "answer the new reviews", "did the new
|
||||
screenshots help". The matching skill takes over.
|
||||

|
||||
|
||||
### Credentials (never in the repo)
|
||||
- [The journey](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/journey.md): every step from setup to Submit, what is API, what the agent drives in a console, what stays yours
|
||||
- [Rejection scan](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/rejections.md): every rule with its App Store guideline or Play policy
|
||||
- [Commands](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/commands.md): the full command reference
|
||||
- [Store art](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/store-art.md): screenshots, fonts, previews, variants
|
||||
- [Growth extras and console forms](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/growth.md): PPP prices, Apple Ads, web presence, RevenueCat, `console plan` / `console fill`
|
||||
- [Many apps, release trains, workflows](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/studios.md) · [Listings in more languages](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/listing-languages.md) · [Every API endpoint](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/api.md)
|
||||
- [Skills](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/skills.md) · [MCP server](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/mcp.md) · [Safety model](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/safety.md) · [Idempotency](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/idempotency.md) · [Pitfalls](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/pitfalls.md)
|
||||
- [Desktop app](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/desktop.md) · [Desktop releases](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/desktop-release.md) · [FAQ](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/faq.md) · [Roadmap, contributing, credits](https://git.crt.fyi/CRT/storebound/src/branch/main/docs/project.md)
|
||||
|
||||
Read from environment variables, or from `.storebound/credentials.json` in your project (gitignored by `init`):
|
||||
## Contributing and license
|
||||
|
||||
| name | what |
|
||||
|---|---|
|
||||
| `PLAY_SERVICE_ACCOUNT` | path to the Google Cloud service account JSON key (or the JSON itself) with access to your app in Play Console |
|
||||
| `ASC_KEY_ID`, `ASC_ISSUER_ID` | App Store Connect API team key (Users and Access > Integrations) |
|
||||
| `ASC_P8` | path to `AuthKey_<id>.p8` (default `~/.appstoreconnect/private_keys/AuthKey_<id>.p8`) |
|
||||
| `reviewContact` | (file only) App Review contact name / phone / email |
|
||||
| `reviewDemoAccount` / `REVIEW_DEMO_USER`, `REVIEW_DEMO_PASSWORD` | demo account for App Review (`reviewAccess.signInRequired`); never in the config or the repo, masked in logs |
|
||||
|
||||
## Install for your AI tool
|
||||
|
||||
Every route gives the agent the same skills and the same MCP tools. Nothing here requires Claude: the skills are
|
||||
plain Markdown and the CLI is a normal command.
|
||||
|
||||
| tool | install |
|
||||
|---|---|
|
||||
| Claude Code | `/plugin marketplace add https://git.crt.fyi/CRT/storebound.git` then `/plugin install storebound@crtkafa` (skills, MCP server, `storebound` on PATH). Or per project: `bunx storebound install --agent claude` |
|
||||
| OpenAI Codex | `bunx storebound install --agent codex` (skills in `.agents/skills`, MCP in `.codex/config.toml`; Codex reads that file for trusted projects). The repo is also a Codex plugin (`.codex-plugin/plugin.json`, skills only) |
|
||||
| Gemini CLI | `gemini extensions install https://git.crt.fyi/CRT/storebound.git` (skills, MCP server, `GEMINI.md`). Or `bunx storebound install --agent gemini` |
|
||||
| Cursor | `bunx storebound install --agent cursor` (skills in `.agents/skills`, `.cursor/mcp.json`); the repo's `.cursor/rules/storebound.mdc` is an agent-requested rule you can copy |
|
||||
| VS Code / GitHub Copilot | `bunx storebound install --agent copilot` (skills in `.github/skills`, `.vscode/mcp.json`) |
|
||||
| Windsurf (Devin Desktop) | `bunx storebound install --agent windsurf` (skills in `.agents/skills`, MCP in your global `mcp_config.json`) |
|
||||
| OpenCode | `bunx storebound install --agent opencode` (skills in `.opencode/skills`, `opencode.json`) |
|
||||
| anything that reads `AGENTS.md` | copy or link `AGENTS.md` (rules + skill index) and use the CLI |
|
||||
|
||||
`install` takes several agents at once (`--agent codex,cursor`), `--dry` to preview, `--no-skills` / `--no-mcp`,
|
||||
and `--command "<cmd>"` to choose how the MCP server starts. It only adds or updates the `storebound` entry and its
|
||||
own skill folders; everything else in those files stays as it is, and re-running it is safe.
|
||||
|
||||
## Commands
|
||||
|
||||
Every write command takes `--dry`; re-runs are idempotent; output is one timestamped line per step, so long jobs can
|
||||
run in the background with a log (`storebound shots render > .storebound/render.log 2>&1 &`).
|
||||
|
||||
<details>
|
||||
<summary><b>Setup and checks</b></summary>
|
||||
|
||||
| command | kind | what |
|
||||
|---|---|---|
|
||||
| `init [--profile app\|game\|subscription-app]` | local | copy the templates of a profile (default app), gitignore `.storebound/` |
|
||||
| `install --agent <tool>` | local | skills + MCP entry for an AI tool |
|
||||
| `mcp` | local | stdio MCP server wrapping the commands |
|
||||
| `check` | local | config, copy limits, data safety, products, subscriptions, profile (delete-account URL, demo account, terms URL), files; warns on untranslated release notes |
|
||||
| `catalog diff [--store] [--threshold 10]` | API, read-only | one catalog vs both stores: missing / extra / mismatched products and subscriptions, US and override prices, locales, offers, per-region price differences between the stores; exit 1 on mismatches |
|
||||
| `check --aso` | local | keyword audit: App Store keyword field rules, Play stuffing / claims |
|
||||
| `validate [--apple] [--play]` | API, read-only | readiness report with ordered blockers plus the local renders checks (`--no-local` skips); exit 1 while any blocker is left |
|
||||
| `whats-new [--since <tag>]` | local | draft player-facing release notes from git log into both listing files |
|
||||
| `privacy-manifest --ios <path>` | local | PrivacyInfo.xcprivacy, required-reason APIs, SDKs without manifests |
|
||||
| `icons` | local | App Store 1024 (no alpha), Play 512, web, Capacitor sources, Android legacy launcher icons |
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Google Play</b></summary>
|
||||
|
||||
| command | kind | what |
|
||||
|---|---|---|
|
||||
| `play listing` | API | app details, title / short / full description per language, promo video URL (`play.video`) |
|
||||
| `play images [--variant b]` | API | icon, feature graphic, phone / 7" / 10" screenshots, one edit per language |
|
||||
| `play products` | API | one-time products: regional prices from `convertRegionPrices` + your overrides, activate |
|
||||
| `play subscriptions [--csv]` | API | subscriptions: listings + benefits, one auto-renewing base plan, regional prices, intro and extra offers, activate (plan first, asks) |
|
||||
| `play data-safety` | API | Data safety form (CSV import); `--csv` writes the file |
|
||||
| `play release <aab>` | API | upload + tracks (`--internal completed --production draft`, `--production inProgress --fraction 0.05`), release notes |
|
||||
| `play rollout` | API | `--fraction x`, `--halt`, `--resume`, `--complete` (asks first, except halt) |
|
||||
| `play next-version-code` | API, read-only | next free versionCode |
|
||||
| `play status` | API, read-only | tracks, listings, products |
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>App Store</b></summary>
|
||||
|
||||
| command | kind | what |
|
||||
|---|---|---|
|
||||
| `apple bundle` | API | register the bundle id, find the app record |
|
||||
| `apple listing --version x.y.z [--build N]` | API | version (manual release), the build with exactly that number, texts per locale |
|
||||
| `apple screenshots [--variant b]` | API | 6.9" + 6.5" (+ 13" iPad with `apple.ipad`, + 6.3" with `apple.iphoneMedium`) per locale, MD5-idempotent |
|
||||
| `apple previews [--poster 5]` | API | app preview videos per locale, checked first, MD5-idempotent, poster frame |
|
||||
| `apple iap` / `apple iap-review` | API | IAPs (consumable, non-consumable, non-renewing), localizations, price schedules, availability / review screenshots |
|
||||
| `apple subscriptions [--csv] [--codes]` | API | groups, subscriptions, levels, localizations, availability, equalized prices + overrides + CSV (scheduled changes), introductory and promotional offers, offer code campaigns, review screenshots (plan first, asks; custom codes only with `--codes`) |
|
||||
| `apple appinfo` | API | categories, age rating, content rights, Free, territories |
|
||||
| `apple review-details` | API | App Review contact, demo account (from `.storebound/`, masked), notes (+ sign-in steps, where account deletion is) |
|
||||
| `apple encryption` | API | export compliance answer from `apple.usesNonExemptEncryption` (never guessed) |
|
||||
| `apple release --phased on\|pause\|resume\|complete`, `--manual-release` | API | phased release, release an approved version (resume / complete / release ask first) |
|
||||
| `apple next-build` | API, read-only | next safe build number |
|
||||
| `apple status` | API | versions, builds, IAPs, submissions; `--wait-review` (exit 0 / 1 / 7); `--cancel-submission <id>` |
|
||||
| `apple ppo status \| create --variant b \| upload --variant b` | API | Product Page Optimization test from `shots` variants: treatments, localizations, screenshot sets |
|
||||
| `apple ppo start \| stop` | API | start / stop the test (asks first; a stopped test cannot be restarted) |
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>TestFlight</b></summary>
|
||||
|
||||
| command | kind | what |
|
||||
|---|---|---|
|
||||
| `apple testflight status` | API, read-only | groups, testers and builds per group, recent builds with internal / external beta states |
|
||||
| `apple testflight groups` | API | create the groups of `apple.testflight.groups` that are missing |
|
||||
| `apple testflight testers [--csv f] [--remove] [--invite]` | API | testers from a CSV in `.storebound/` into their groups (asks first; emails masked) |
|
||||
| `apple testflight what-to-test --build N` | API | "What to Test" per locale from `store/appstore.md` (`whatToTest`, else `whatsNew`) |
|
||||
| `apple testflight info` | API | Beta App Description, feedback email, URLs, Beta App Review contact and notes |
|
||||
| `apple testflight distribute --build N --group a,b [--submit-review]` | API | the build to groups; external groups and Beta App Review ask first |
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>After launch</b></summary>
|
||||
|
||||
| command | kind | what |
|
||||
|---|---|---|
|
||||
| `health [--weekly] [--days 7]` | API, read-only | Play vitals (user-perceived crash / ANR vs 1.09 % / 0.47 %, devices, top issues), App Store metrics, diagnostics, TestFlight crashes; `--weekly` writes a Markdown report |
|
||||
| `reviews list [--unanswered]` | API, read-only | recent reviews of both stores |
|
||||
| `reviews draft` | API + local | one reply draft per unanswered review in `.storebound/replies/` |
|
||||
| `reviews send` | API | sends drafts with `approved: true` (checks length and incentives, asks first) |
|
||||
| `prices export` | API + local | current prices of every product, both stores, as `store/prices.csv` |
|
||||
| `prices import [--reconvert]` | API | diff table, then (asks first) Apple price schedules incl. future-dated changes and Play regional prices |
|
||||
| `analytics setup` | API | App Store analytics report request (once, Admin key) |
|
||||
| `analytics snapshot [--days 28]` | API + local | impressions, page views, downloads (App Store), visitors, acquisitions, installs (Play reports bucket) -> `.storebound/analytics/` |
|
||||
| `analytics compare` | local | snapshots vs the git history of the store files: before / after each listing change |
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Screenshots and video</b></summary>
|
||||
|
||||
| command | kind | what |
|
||||
|---|---|---|
|
||||
| `shots capture [--source web\|ios-sim\|android-emu\|folder]` | local | raw frames from your running app or game |
|
||||
| `shots fonts` | network | font subsets for your copy (Noto for CJK / Arabic / Cyrillic / Devanagari ...) |
|
||||
| `shots render [--variant b \| --variants]` | local | every store size and language in the game or app style, feature graphic, contact sheet, overflow report |
|
||||
| `shots jpeg` | local | JPEG q92 copies of the Play renders (about 4x faster uploads) |
|
||||
| `shots check [--variants] [--json]` | local, read-only | store rules: sizes, alpha, format, bytes, counts, overflow, videos, folder frames |
|
||||
| `shots gallery` | local | `<renders>/index.html` review page |
|
||||
| `shots record [--source ...]` | local | app or gameplay clips: web (Chromium screencast), simulator, emulator, folder |
|
||||
| `shots video [--target iphone,ipad,youtube]` | local | app previews + promo video with captions, poster, checks |
|
||||
|
||||
</details>
|
||||
|
||||
## Store art
|
||||
|
||||
Screenshots and previews are one step of the journey, but the one that takes the longest by hand, so storebound
|
||||
does a lot here. Two looks: `shots.style: 'game'` (sunburst, sparkles, badges) and `shots.style: 'app'` (calm
|
||||
gradient, a clean device frame, headline + subline). Everything below was made by storebound itself from two tiny
|
||||
fictional demos: [a game](examples/demo-game) ("Prism Puddle", procedural art) and [an app](examples/demo-app)
|
||||
("Tidy Lists", one static page with sample data): raw frames captured from the web build, captions in several
|
||||
languages, every store size, a review gallery and an app preview video. No store account needed to try it.
|
||||
|
||||

|
||||
|
||||

|
||||
|
||||
| Play feature graphic | App preview (App Store, 886 x 1920) |
|
||||
|---|---|
|
||||
|  |  |
|
||||
|
||||

|
||||
|
||||
<details>
|
||||
<summary>Contact sheet of one language (every size, packed into a grid)</summary>
|
||||
|
||||

|
||||
|
||||
</details>
|
||||
|
||||
### How it works
|
||||
|
||||
1. **Frames.** Give your app or game a few switches (language, demo data or a fixed seed, no ads, jump to a screen,
|
||||
freeze, autoplay) and
|
||||
let `shots capture` take the frames: Playwright for a web build, `simctl` for anything that runs in the iOS
|
||||
Simulator (Unity, Godot, Flutter, React Native, native, Capacitor), `adb` for an Android emulator or device, or bring a folder of
|
||||
your own frames. The status bar is cropped off and redrawn clean (9:41, full battery).
|
||||
2. **Copy.** Per language and scene: eyebrow, two-line title, subtitle, badges. Fonts are subset from Google Fonts to
|
||||
exactly your characters, so Japanese, Chinese, Korean, Arabic (right to left) and Hindi just work.
|
||||
3. **Render.** Every store size at exact pixels: iPhone 6.9" and 6.5", 13" iPad (if your app runs on iPad), Play
|
||||
phone, 7" and 10" tablets, the 1024 x 500 feature graphic. 24-bit RGB, no alpha (both stores reject it).
|
||||
4. **Check and review.** `shots check` applies the store rules locally (sources cited in `cli/shots/spec.ts`);
|
||||
`shots gallery` puts everything on one page with problems outlined. `validate` repeats the checks next to the
|
||||
store state.
|
||||
5. **Variants.** Other first screenshot, order or copy as `shots.variants`, rendered side by side, for a Play store
|
||||
listing experiment or an App Store Product Page Optimization test (set up in the consoles; storebound makes and
|
||||
checks the images).
|
||||
6. **Video.** `shots record` films the autoplay mode, `shots video` cuts 15-30 s App Store previews (886 x 1920,
|
||||
1200 x 1600) and a 9:16 / 16:9 promo for YouTube with captions in every language, `apple previews` uploads them.
|
||||
Play takes a YouTube URL in `play.video`.
|
||||
|
||||
Details: the [store-screenshots](skills/store-screenshots/SKILL.md) and [app-previews](skills/app-previews/SKILL.md)
|
||||
skills.
|
||||
|
||||
## Skills
|
||||
|
||||
In journey order. Each one says which steps are API (storebound) and which are console clicks, with the exact
|
||||
navigation.
|
||||
|
||||
| skill | for |
|
||||
|---|---|
|
||||
| `play-first-release` | Google Play from zero to "In review" |
|
||||
| `appstore-first-release` | App Store from API key to "Waiting for review", incl. xcodebuild with the API key |
|
||||
| `testflight` | beta groups, testers from a CSV that never enters git, What to Test, Test Information, Beta App Review |
|
||||
| `store-iap-setup` | in-app products on both stores (consumable, non-consumable, non-renewing), prices and the price sheet CSV, catalog diff, testers, the first-IAP-with-version rule |
|
||||
| `store-subscriptions` | subscription groups, levels, base plans, prices, intro and promotional offers, offer codes, disclosure and Terms (3.1.2), first submission |
|
||||
| `review-access` | demo account for reviewers (App Review fields, Play App access), never committed |
|
||||
| `account-deletion` | Apple 5.1.1(v) in-app deletion, Play delete-account web page and Data safety |
|
||||
| `aso-basics` | keyword field, subtitle, cross-localization, Play placement without stuffing |
|
||||
| `store-declarations` | every questionnaire: Play Data safety (API) and App content (IARC, target audience, ads, advertising ID, app access, government / financial / health), Apple App Privacy labels and age rating |
|
||||
| `export-compliance` | encryption answer, Info.plist key, declarations; never exempt by default |
|
||||
| `privacy-policy` | one policy page for all your apps with a per-app services table (templates per profile) |
|
||||
| `privacy-manifest` | PrivacyInfo.xcprivacy, required-reason APIs, SDK manifests (ITMS-91053 / 91061) |
|
||||
| `app-icons` | one artwork to every icon, adaptive / legacy launcher pitfalls |
|
||||
| `store-screenshots` | capture from any engine, copy, fonts, render, checks, gallery, variants, App Store product page tests, Play experiments, upload |
|
||||
| `app-previews` | app or gameplay clips, App Store previews, Play promo video, checks, upload |
|
||||
| `store-preflight` | run and read `check`, `check --aso`, `validate`, `privacy-manifest` before submitting |
|
||||
| `release-management` | updates: Apple phased + manual release, Play staged rollout, halt / pause (not a rollback), review wait |
|
||||
| `store-health` | crash / ANR vitals vs Play's bad behavior thresholds, App Store diagnostics, weekly report |
|
||||
| `review-replies` | reply drafts, tone, no incentives, store limits, the owner approves and sends |
|
||||
| `store-analytics` | App Store analytics reports, Play reports bucket, before / after listing changes |
|
||||
| `whats-new` | player-facing release notes from git, localized, within store limits |
|
||||
| `review-rejections` | triage a rejection (fix / clarify / push back / appeal), reply template, the guidelines apps and games hit |
|
||||
| `ads-mediation-checks` | AdMob, AppLovin MAX and LevelPlay: ids, debug tools, adapters, app-ads.txt, SKAdNetwork, no-fill (`ads-levelplay-checks` stays as a pointer) |
|
||||
| `portfolio-originality` | Guideline 4.3 gate for developers shipping many similar apps or games |
|
||||
|
||||
## MCP server
|
||||
|
||||
`storebound mcp` speaks MCP over stdio, tools only: spec revision **2026-07-28** (stateless: `server/discover`,
|
||||
per-request `_meta`, `resultType`, cacheable `tools/list`) and, on the same process, clients that still open with
|
||||
`initialize` (2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05). It runs each tool as a CLI call in the project directory
|
||||
(the server's working directory, or `STOREBOUND_PROJECT`) and returns the output.
|
||||
|
||||
- One tool per command. Read-only: `check`, `check_aso`, `validate`, `catalog_diff`, `health`, `reviews_list`, `prices_diff`,
|
||||
`analytics_compare`, `apple_status`, `apple_next_build`, `apple_testflight_status`, `apple_ppo_status`,
|
||||
`play_status`, `play_next_version_code`, `privacy_manifest`, `shots_check`. Local writes: `whats_new`, `icons`,
|
||||
`health_report`, `reviews_draft`, `prices_export`, `analytics_snapshot`, `shots_capture`, `shots_render`,
|
||||
`shots_gallery`, `shots_record`, `shots_video`. Store writes: `play_listing`, `play_images`, `play_products`,
|
||||
`play_data_safety`, `play_subscriptions`, `play_release_testing`, `apple_bundle`, `apple_iap`, `apple_iap_review`,
|
||||
`apple_subscriptions`, `apple_listing`,
|
||||
`apple_screenshots`, `apple_previews`, `apple_appinfo`, `apple_review_details`, `apple_encryption`,
|
||||
`apple_phased_release`, `apple_testflight_groups`, `apple_testflight_what_to_test`, `apple_testflight_info`,
|
||||
`apple_testflight_distribute` (internal groups only), `apple_ppo_create`, `apple_ppo_upload`, `analytics_setup`.
|
||||
- Annotations say what is read-only, destructive (replaces data), idempotent and network-bound.
|
||||
- No MCP SDK: a small newline-delimited JSON-RPC server (server/discover, initialize, ping, tools/list, tools/call,
|
||||
cancellation), so storebound keeps zero runtime dependencies.
|
||||
|
||||
Manual config for a tool that `install` does not know: command `bunx` with args `["storebound", "mcp"]` (or the
|
||||
absolute path of `bin/storebound` plus `mcp`).
|
||||
|
||||
## Safety model
|
||||
|
||||
- **Credentials** live in env vars or the gitignored `.storebound/credentials.json`, never in the config or the repo.
|
||||
storebound only talks to the official store APIs (plus Google Fonts, your own Play reports bucket and your own URLs);
|
||||
see [SECURITY.md](SECURITY.md).
|
||||
- **Dry run everywhere.** Every write command takes `--dry`; every MCP write tool has `dry_run`, **default true**.
|
||||
- **Nothing public or irreversible through an agent.** Submitting for review (App Review and Beta App Review),
|
||||
releasing a version, production releases, resuming or completing a rollout or phased release, canceling a
|
||||
submission, deleting, inviting or removing testers, sending review replies, applying prices and starting or
|
||||
stopping a product page test and creating custom offer codes are not MCP tools. Subscription syncs through MCP only
|
||||
create what is new; price changes of live subscriptions wait for a terminal run. They stay terminal commands that ask for confirmation, and the skills tell every agent to ask the owner
|
||||
first ([docs/agents-core.md](docs/agents-core.md)).
|
||||
- **Personal data stays local.** Tester lists, the App Review demo account, reply drafts, health reports and analytics
|
||||
snapshots live in the gitignored `.storebound/` (the demo account is masked in every log line); tester emails are masked in every log line, and the config refuses a tester CSV path
|
||||
outside `.storebound/`.
|
||||
- **Idempotent writes.** Re-running a command converges (MD5 checks for screenshots and previews, one Play edit per
|
||||
language), so a failed upload is fixed by running it again.
|
||||
- **Simulators and emulators**: storebound shuts down only a simulator it booted itself and never boots, wipes or
|
||||
reboots an Android emulator or device.
|
||||
|
||||
## FAQ
|
||||
|
||||
**Is it only for games?** No. It started with my game, but every command is about store records, not engines or
|
||||
genres. `init --profile app` and `--profile subscription-app` give you templates for a utility app with accounts and
|
||||
for a subscription app (Data safety, App Privacy, declarations, listing and screenshot copy), the `app` screenshot
|
||||
style, account deletion and demo account checks, and subscriptions on both stores. Game-only advice (IARC game
|
||||
questions, gameplay footage, ad mediation) is marked as such in the skills.
|
||||
|
||||
**Do I need Claude (or any AI tool)?** No. The CLI is a normal command and the skills are Markdown checklists you can
|
||||
read yourself. The AI integrations are optional adapters generated from the same files.
|
||||
|
||||
**Does it fill the questionnaires?** The ones with an API, yes: Play Data safety (the whole form from `dataSafety` in
|
||||
the config; the import replaces the form, so the config is the single truth), Apple age rating, content rights,
|
||||
categories, price and availability, the export compliance answer and the App Review details. The stores have no
|
||||
public API for Play's App content cards (IARC content rating, target audience, ads, advertising ID, app access,
|
||||
government / financial / health / news) or for Apple's App Privacy labels. For those, `init` gives you prepared
|
||||
answers (`store/declarations.md`, `store/app-privacy.md`, per profile: a utility app with an account, a subscription
|
||||
app, or a free-to-play game with ads and IAP),
|
||||
and the `store-declarations` skill has the exact clicks: an agent with browser tools can fill them in while you
|
||||
watch, or you copy them in yourself. Either way the answers are your statements to the stores: change what does not
|
||||
match your app, and the agent asks you whenever the code does not prove an answer. `validate` cannot see these
|
||||
forms, so `store-preflight` lists them as a manual check.
|
||||
|
||||
**My app or game is Unity / Godot / Flutter / React Native / native, not web.** Screenshots and clips come from the iOS Simulator
|
||||
(`ios-sim`), an Android emulator or device (`android-emu`) or a folder you fill with any tool; only the rendering of
|
||||
the store images uses a headless browser. The store commands do not care about the engine at all: they work on
|
||||
your AAB / build numbers and listing files.
|
||||
|
||||
**Is my store account safe?** storebound uses the official APIs with keys you create and can revoke, never your
|
||||
password. Store writes are dry runs until you say otherwise, and the public steps (submit, release) stay with you.
|
||||
Use an App Store Connect key with the App Manager role and a Play service account limited to your app.
|
||||
|
||||
**Why Bun?** One fast runtime with TypeScript, `fetch`, a test runner and a static server built in: no build step and
|
||||
zero runtime dependencies. It needs Bun installed (it does not run on plain Node).
|
||||
|
||||
**Does it upload my video to YouTube?** No. Play only takes a YouTube URL, and uploading to YouTube needs your Google
|
||||
account; `shots video` makes the file, you upload it and paste the URL into `play.video`.
|
||||
|
||||
**Can it run store experiments for me?** On the App Store, mostly: `apple ppo create / upload` builds a Product Page
|
||||
Optimization test from your `shots` variants (treatments, locales, screenshots) and you start it (`apple ppo start`
|
||||
asks first). Results per treatment are only shown in App Store Connect. Play store listing experiments have no API:
|
||||
storebound renders and checks the variant images, you set the experiment up in Play Console.
|
||||
|
||||
**Does it answer reviews by itself?** No. It drafts one file per review, your agent helps write the replies, and only
|
||||
the drafts you mark `approved: true` are sent, by you, after a confirmation. Replies that offer something for a rating
|
||||
are refused.
|
||||
|
||||
## Roadmap
|
||||
|
||||
Wave 2 (TestFlight, vitals, review replies, price sheets, analytics, MCP 2026-07-28, Product Page Optimization) shipped
|
||||
in 0.4.0. 0.5.0 made storebound app-first (profiles, app screenshot style, account deletion, review access) and
|
||||
brought the full in-app catalog: subscriptions on both stores with offers and offer codes, non-renewing products and
|
||||
the cross-store `catalog diff`. Next, roughly in this order:
|
||||
|
||||
- Offer codes for one-time products (`inAppPurchaseOfferCodes`), Play prepaid base plans for `non_renewing`, win-back
|
||||
offers, and a `prices export` that includes subscriptions.
|
||||
- App Store custom product pages and in-app events from the same copy and renders.
|
||||
- Play store listing experiments and their results, as soon as Google offers an API.
|
||||
- App preview treatments and alternate icons in Product Page Optimization tests.
|
||||
- The iPhone Duo screenshot classes Apple lists for apps built with the iOS 27.1 SDK (required from April 2027).
|
||||
|
||||
## Contributing
|
||||
|
||||
Issues and pull requests are welcome: store rule updates (with a source), new capture sources, adapters for more AI
|
||||
tools. See [CONTRIBUTING.md](CONTRIBUTING.md); `bun run ci` must be green.
|
||||
|
||||
<details>
|
||||
<summary><b>Agent support: formats and what is not verified</b></summary>
|
||||
|
||||
Checked against each tool's own docs in October 2026:
|
||||
|
||||
- **Agent Skills**: frontmatter is only `name` (lowercase-hyphen, equals the folder) and `description`; the generator
|
||||
fails if a skill adds anything else.
|
||||
- **Claude Code**: plugin manifest + root `.mcp.json` with `${CLAUDE_PLUGIN_ROOT}`; `claude plugin validate .` passes.
|
||||
- **Codex**: `.codex-plugin/plugin.json` with `"skills": "./skills/"`. Not verified: whether Codex starts the root
|
||||
`.mcp.json` from a plugin and expands `${CLAUDE_PLUGIN_ROOT}` there, so use `install --agent codex` for the MCP
|
||||
server. OpenAI also documents a newer portable root `plugin.json`; not shipped yet.
|
||||
- **Gemini CLI**: `gemini-extension.json` with `${extensionPath}${/}`, `GEMINI.md` as context, `skills/` inside the
|
||||
extension. Google now points unpaid users to Antigravity CLI; not tested there. The `.gemini/skills` folder used by
|
||||
`install --agent gemini` is not verified (the extension route is).
|
||||
- **Windsurf**: the current docs name `~/.config/devin/mcp_config.json`; `install` keeps using
|
||||
`~/.codeium/windsurf/mcp_config.json` when that file already exists (older installs).
|
||||
- **MCP**: built for 2026-07-28 (final, modelcontextprotocol.io) and dual-era: `initialize` clients get 2025-11-25
|
||||
(or 2025-06-18 / 2025-03-26 / 2024-11-05). Tested with both handshakes on one stdio process, not yet against every
|
||||
client listed above.
|
||||
- **Not verified against a live account yet** (no credentials during development; request builders are tested with
|
||||
fixtures from the official docs): the scale of the Play Reporting API rates (read as fractions, 0.0109 = 1.09 %),
|
||||
the App Store review reply limit (5970 characters is commonly reported; Apple documents none, storebound only
|
||||
warns), the TestFlight "What to Test" limit (4000 assumed), whether an analytics segment checksum covers the gzip
|
||||
file or its content (both are accepted), that a new App Store price schedule replaces the old one (Apple's example
|
||||
implies it), stopping a Product Page Optimization test with `started: false`, and `APP_IPHONE_61` for the 6.3"
|
||||
iPhone set. From 0.5.0 (request bodies follow Apple's and Google's published schemas, tested with fixtures, not
|
||||
yet run against a live account): free promotional offers and offer codes sent with territories but no price point,
|
||||
subscription prices and introductory offers created inline through `PATCH /v1/subscriptions/{id}`, Play
|
||||
pay-as-you-go offers as a `relativeDiscount`, Play "developer determined" offers as offers without targeting plus an
|
||||
offer tag, the ISO 8601 strings for Play billing periods (Google lists them only in words), the Play subscription
|
||||
benefit length (40, from Play Console), the Data safety sign-up method ids (`PSL_ACM_*`, Google publishes none:
|
||||
compare with a Console export) and the delete-account URL question id (use `dataSafety.extra`).
|
||||
- **Apple IAP description**: 45 characters (App Store Connect Help, "In-app purchase information"); an older App Store
|
||||
marketing page says 55. storebound checks 45.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Develop</b></summary>
|
||||
|
||||
```sh
|
||||
bun install
|
||||
bun run ci # adapters fresh (gen-adapters --check), tests, typecheck, secrets / personal data scrub
|
||||
bun tools/gen-adapters.ts # after editing skills/*/SKILL.md or docs/agents-core.md
|
||||
```
|
||||
|
||||
`skills/*/SKILL.md` and `docs/agents-core.md` are the single source; `AGENTS.md`, `GEMINI.md`, the plugin manifests,
|
||||
`.github/copilot-instructions.md` and `.cursor/rules/storebound.mdc` are generated and committed, and CI fails when
|
||||
they are stale.
|
||||
|
||||
</details>
|
||||
|
||||
## Thanks and idea sources
|
||||
|
||||
Some skills were sparked by other people's open work. I wrote my own text; the ideas deserve the credit:
|
||||
|
||||
- [rorkai/app-store-connect-cli-skills](https://github.com/rorkai/app-store-connect-cli-skills) (MIT): App Store Connect
|
||||
workflow ideas.
|
||||
- [rshankras/claude-code-apple-skills](https://github.com/rshankras/claude-code-apple-skills) (MIT): Apple platform and
|
||||
App Store topic ideas.
|
||||
|
||||
Built with Bun and plain `fetch` against the Google Play Developer API v3, the Play Developer Reporting API and the App
|
||||
Store Connect API. Screenshot
|
||||
fonts come from Google Fonts at render time (Noto, Lilita One, Montserrat; SIL Open Font License 1.1). Not affiliated
|
||||
with Google or Apple.
|
||||
|
||||
## License
|
||||
|
||||
MIT, see [LICENSE](LICENSE). Copyright (c) 2026 CRTkafa.
|
||||
Issues and pull requests are welcome; see [CONTRIBUTING.md](https://git.crt.fyi/CRT/storebound/src/branch/main/CONTRIBUTING.md) (`bun run ci` must be green).
|
||||
MIT, see [LICENSE](https://git.crt.fyi/CRT/storebound/src/branch/main/LICENSE). Copyright (c) 2026 CRTkafa. Not affiliated with Google or Apple.
|
||||
|
|
|
|||
68
apps/desktop/build/freeze-safe.ts
Normal file
|
|
@ -0,0 +1,68 @@
|
|||
// Tauri's `freezePrototype: true` (tauri.conf.json) runs Object.freeze(Object.prototype) before any page script. In
|
||||
// strict code, assigning a property that an object only inherits from the frozen Object.prototype (`constructor`,
|
||||
// `toString`, ...) then throws "Cannot assign to read only property": the JavaScript "override mistake". d3-color and
|
||||
// d3-format (under @visx/scale) do exactly that while their modules load, so the bundle stopped before React rendered
|
||||
// anything and the release window showed only its background colour.
|
||||
//
|
||||
// This plugin rewrites every `x.constructor = v`, `x.toString = v`, ... in dependencies into a call that does the same
|
||||
// assignment and, only when that assignment hits the frozen prototype, defines the property on `x` itself instead
|
||||
// (Object.defineProperty is allowed there). The release boot check (tools/desktop-boot-check.ts) loads the built
|
||||
// bundle with the prototype frozen, as Tauri does, and fails on any uncaught error.
|
||||
import type { Plugin } from 'vite';
|
||||
|
||||
/** The writable data properties of Object.prototype that freezing turns read-only for every plain object. */
|
||||
export const FROZEN_NAMES = ['constructor', 'toString', 'toLocaleString', 'valueOf', 'hasOwnProperty', 'isPrototypeOf', 'propertyIsEnumerable'] as const;
|
||||
const QUICK = new RegExp(`\\.(?:${FROZEN_NAMES.join('|')})\\s*=(?!=)`);
|
||||
export const HELPER = '__storeboundFreezeSafeSet';
|
||||
// Appended (function declarations hoist), so a leading "use strict" directive stays first. Works in strict and sloppy
|
||||
// code: when `k` is only inherited from a frozen (read-only) data property, define it on `o`; otherwise assign.
|
||||
const HELPER_SRC = `\nfunction ${HELPER}(o, k, v) { if (o !== null && (typeof o === 'object' || typeof o === 'function') && !Object.prototype.hasOwnProperty.call(o, k)) { for (var p = Object.getPrototypeOf(o); p !== null; p = Object.getPrototypeOf(p)) { var d = Object.getOwnPropertyDescriptor(p, k); if (!d) continue; if ('value' in d && !d.writable) { Object.defineProperty(o, k, { value: v, writable: true, enumerable: true, configurable: true }); return v; } break; } } o[k] = v; return v; }\n`;
|
||||
|
||||
interface Node { type: string; start: number; end: number; [k: string]: unknown }
|
||||
|
||||
function walk(node: unknown, visit: (n: Node) => void): void {
|
||||
if (!node || typeof node !== 'object') return;
|
||||
if (Array.isArray(node)) { for (const n of node) walk(n, visit); return; }
|
||||
const n = node as Node;
|
||||
if (typeof n.type === 'string') visit(n);
|
||||
for (const k of Object.keys(n)) if (k !== 'type' && k !== 'start' && k !== 'end') walk(n[k], visit);
|
||||
}
|
||||
|
||||
/** Rewrites the assignments in one module's code; null when there is nothing to change. */
|
||||
export function rewrite(code: string, parse: (code: string) => unknown): string | null {
|
||||
if (!QUICK.test(code)) return null;
|
||||
const edits: { start: number; end: number; text: (inner: (s: number, e: number) => string) => string }[] = [];
|
||||
walk(parse(code), n => {
|
||||
if (n.type !== 'AssignmentExpression' || n.operator !== '=') return;
|
||||
const left = n.left as Node & { object: Node; property: Node & { name?: string }; computed: boolean; optional?: boolean };
|
||||
if (left.type !== 'MemberExpression' || left.computed || left.object.type === 'Super') return;
|
||||
if (!(FROZEN_NAMES as readonly string[]).includes(left.property.name ?? '')) return;
|
||||
const right = n.right as Node;
|
||||
edits.push({ start: n.start, end: n.end, text: inner => `${HELPER}(${inner(left.object.start, left.object.end)}, ${JSON.stringify(left.property.name)}, ${inner(right.start, right.end)})` });
|
||||
});
|
||||
if (!edits.length) return null;
|
||||
// outermost edits only carry their inner text through `inner`, which applies nested edits recursively
|
||||
edits.sort((a, b) => a.start - b.start || b.end - a.end);
|
||||
const render = (s: number, e: number): string => {
|
||||
let out = '', at = s;
|
||||
for (const ed of edits) {
|
||||
if (ed.start < at || ed.end > e || ed.start < s) continue;
|
||||
out += code.slice(at, ed.start) + ed.text(render);
|
||||
at = ed.end;
|
||||
}
|
||||
return out + code.slice(at, e);
|
||||
};
|
||||
return render(0, code.length) + HELPER_SRC;
|
||||
}
|
||||
|
||||
export function freezeSafe(): Plugin {
|
||||
return {
|
||||
name: 'storebound-freeze-safe',
|
||||
transform(code, id) {
|
||||
const file = id.split('?')[0]!;
|
||||
if (!/node_modules/.test(file) || !/\.(?:m?js|cjs)$/.test(file)) return null;
|
||||
const out = rewrite(code, c => this.parse(c));
|
||||
return out === null ? null : { code: out, map: null };
|
||||
},
|
||||
};
|
||||
}
|
||||
14
apps/desktop/card.html
Normal file
|
|
@ -0,0 +1,14 @@
|
|||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
<meta name="color-scheme" content="light dark" />
|
||||
<link rel="icon" href="data:," />
|
||||
<title>storebound</title>
|
||||
</head>
|
||||
<body class="tc-page">
|
||||
<div id="card"></div>
|
||||
<script type="module" src="/src/card/main.tsx"></script>
|
||||
</body>
|
||||
</html>
|
||||
16
apps/desktop/index.html
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
<meta name="color-scheme" content="light dark" />
|
||||
<link rel="icon" href="data:," />
|
||||
<title>storebound</title>
|
||||
<!-- before the bundle: an error panel instead of an empty window if the bundle fails (public/boot.js) -->
|
||||
<script src="/boot.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<div id="root"></div>
|
||||
<script type="module" src="/src/main.tsx"></script>
|
||||
</body>
|
||||
</html>
|
||||
41
apps/desktop/package.json
Normal file
|
|
@ -0,0 +1,41 @@
|
|||
{
|
||||
"name": "@storebound/desktop",
|
||||
"version": "0.8.78",
|
||||
"private": true,
|
||||
"license": "MIT",
|
||||
"type": "module",
|
||||
"description": "storebound desktop: every game's releases on both stores in one window (Tauri shell around the storebound CLI sidecar).",
|
||||
"scripts": {
|
||||
"dev": "vite --host 127.0.0.1 --port 1420 --strictPort",
|
||||
"build": "tsc --noEmit && vite build",
|
||||
"typecheck": "tsc --noEmit",
|
||||
"test": "bun test tests",
|
||||
"sidecar": "bun ../../tools/build-sidecars.ts --host",
|
||||
"tauri": "tauri",
|
||||
"app:dev": "bun run sidecar && tauri dev",
|
||||
"app:build:debug": "bun run sidecar && tauri build --debug --no-bundle"
|
||||
},
|
||||
"dependencies": {
|
||||
"@phosphor-icons/react": "^2.1.10",
|
||||
"@tauri-apps/api": "^2.12.0",
|
||||
"@visx/axis": "^4.0.0",
|
||||
"@visx/curve": "^4.0.0",
|
||||
"@visx/event": "^4.0.0",
|
||||
"@visx/gradient": "^4.0.0",
|
||||
"@visx/group": "^4.0.0",
|
||||
"@visx/responsive": "^4.0.0",
|
||||
"@visx/scale": "^4.0.0",
|
||||
"@visx/shape": "^4.0.0",
|
||||
"@visx/tooltip": "^4.0.0",
|
||||
"react": "^19.2.0",
|
||||
"react-dom": "^19.2.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@tauri-apps/cli": "^2.12.1",
|
||||
"@types/react": "^19.2.0",
|
||||
"@types/react-dom": "^19.2.0",
|
||||
"@vitejs/plugin-react": "^4.7.0",
|
||||
"typescript": "5.9.3",
|
||||
"vite": "^6.3.0"
|
||||
}
|
||||
}
|
||||
136
apps/desktop/public/boot.js
Normal file
|
|
@ -0,0 +1,136 @@
|
|||
// storebound desktop: the first script of the window (a plain script, loaded before the app bundle; CSP allows only
|
||||
// files of the app). If the bundle fails to load or React never draws (or later unmounts after an error no boundary
|
||||
// caught), the window would show nothing but its background colour. This shows a plain error panel instead, with
|
||||
// Copy details, Reload and Reset saved state (keeps a backup), and sends the error to logs/webview.log through the
|
||||
// app's `log_webview` command until src/lib/crash.ts takes over. No framework, no strings from the network.
|
||||
(function () {
|
||||
'use strict';
|
||||
var errors = [];
|
||||
var shown = false;
|
||||
|
||||
function invoke(cmd, args) {
|
||||
try {
|
||||
var i = window.__TAURI_INTERNALS__;
|
||||
if (i && typeof i.invoke === 'function') return Promise.resolve(i.invoke(cmd, args || {})).catch(function () { return null; });
|
||||
} catch (e) { /* no host */ }
|
||||
return Promise.resolve(null);
|
||||
}
|
||||
function text(e) {
|
||||
if (!e) return 'unknown error';
|
||||
if (e instanceof Error) return e.name + ': ' + e.message;
|
||||
if (typeof e === 'string') return e;
|
||||
if (typeof e.message === 'string') return e.message;
|
||||
try { return JSON.stringify(e); } catch (x) { return String(e); }
|
||||
}
|
||||
function root() { return document.getElementById('root'); }
|
||||
function blank() { var r = root(); return !r || r.childElementCount === 0; }
|
||||
function booted() { return document.documentElement.getAttribute('data-booted') === '1'; }
|
||||
|
||||
function record(where, e, stack) {
|
||||
var msg = text(e);
|
||||
var entry = where + ': ' + msg + (stack ? '\n' + stack : '');
|
||||
errors.push(entry);
|
||||
if (errors.length > 20) errors.shift();
|
||||
// src/lib/crash.ts logs once the bundle is running; before that, this does
|
||||
if (!window.__storeboundCrashHandlers) invoke('log_webview', { level: 'error', message: where + ': ' + msg, detail: stack || null });
|
||||
// after start: at once; while starting, give React a moment (a non-fatal start error does not blank the window)
|
||||
setTimeout(check, booted() ? 60 : 1500);
|
||||
}
|
||||
|
||||
function el(tag, cls, txt) {
|
||||
var n = document.createElement(tag);
|
||||
if (cls) n.className = cls;
|
||||
if (txt) n.textContent = txt;
|
||||
return n;
|
||||
}
|
||||
|
||||
function show(title, lead) {
|
||||
if (shown) return;
|
||||
shown = true;
|
||||
var detail = 'storebound desktop · ' + (booted() ? 'after start' : 'during start') + ' · ' + new Date().toISOString() + '\n' +
|
||||
(navigator.userAgent || '') + '\n\n' + (errors.length ? errors.join('\n\n') : 'No error was reported: the window stayed empty.');
|
||||
var host = root() || document.body;
|
||||
while (host.firstChild) host.removeChild(host.firstChild);
|
||||
var wrap = el('div', 'crash crash-full');
|
||||
wrap.id = 'boot-fallback';
|
||||
wrap.setAttribute('role', 'alert');
|
||||
wrap.setAttribute('data-crash', 'boot');
|
||||
var box = el('div', 'crash-box');
|
||||
box.appendChild(el('h2', '', title));
|
||||
box.appendChild(el('p', '', lead));
|
||||
box.appendChild(el('pre', 'crash-msg selectable', errors.length ? errors[errors.length - 1].split('\n')[0] : 'The window stayed empty.'));
|
||||
var det = el('details');
|
||||
det.appendChild(el('summary', '', 'Details'));
|
||||
det.appendChild(el('pre', 'crash-detail selectable', detail));
|
||||
box.appendChild(det);
|
||||
var note = el('p', 'small muted');
|
||||
note.setAttribute('role', 'status');
|
||||
var actions = el('div', 'actions');
|
||||
var copy = el('button', 'btn', 'Copy details');
|
||||
copy.onclick = function () {
|
||||
var done = function (ok) { note.textContent = ok ? 'Details copied.' : 'Could not copy: select the details and copy them by hand.'; };
|
||||
try {
|
||||
navigator.clipboard.writeText(detail).then(function () { done(true); }, function () { done(fallbackCopy(detail)); });
|
||||
} catch (e) { done(fallbackCopy(detail)); }
|
||||
};
|
||||
var reload = el('button', 'btn btn-primary', 'Reload');
|
||||
reload.onclick = function () { location.reload(); };
|
||||
var reset = el('button', 'btn btn-ghost', 'Reset saved state (keeps a backup)');
|
||||
reset.title = 'Starts with an empty list. The saved state is kept as a backup file, store keys stay in the keychain, app folders are not touched.';
|
||||
reset.onclick = function () {
|
||||
invoke('state_reset').then(function (backup) {
|
||||
if (backup === null || backup === undefined) return;
|
||||
note.textContent = 'Saved state reset. Backup: ' + (backup || '-') + '. Reloading…';
|
||||
setTimeout(function () { location.reload(); }, 1200);
|
||||
});
|
||||
};
|
||||
actions.appendChild(copy);
|
||||
actions.appendChild(reload);
|
||||
actions.appendChild(reset);
|
||||
box.appendChild(actions);
|
||||
box.appendChild(note);
|
||||
box.appendChild(el('p', 'small muted', 'Also written to logs/webview.log in the app data folder (home folder shown as ~, no keys).'));
|
||||
wrap.appendChild(box);
|
||||
host.appendChild(wrap);
|
||||
}
|
||||
|
||||
function fallbackCopy(s) {
|
||||
try {
|
||||
var ta = el('textarea', 'sr');
|
||||
ta.value = s;
|
||||
document.body.appendChild(ta);
|
||||
ta.select();
|
||||
var ok = document.execCommand('copy');
|
||||
ta.remove();
|
||||
return ok;
|
||||
} catch (e) { return false; }
|
||||
}
|
||||
|
||||
function check() {
|
||||
if (shown || !blank() || !document.body) return;
|
||||
if (booted()) show('storebound hit an error', 'The window was closed by an error. Your app folders, store keys and saved data are untouched. Reload usually fixes it; if it keeps happening, copy the details into a bug report.');
|
||||
else if (errors.length) show('storebound could not start', 'The window failed while starting. Your app folders, store keys and saved data are untouched. Reload, or reset the saved state if it keeps happening, and copy the details into a bug report.');
|
||||
}
|
||||
|
||||
window.addEventListener('error', function (ev) {
|
||||
// a script or stylesheet that failed to load has no ev.error
|
||||
var t = ev.target;
|
||||
if (t && t !== window && (t.src || t.href)) { record('load', 'could not load ' + (t.src || t.href)); return; }
|
||||
record('window.onerror', ev.error || ev.message, ev.error && ev.error.stack);
|
||||
}, true);
|
||||
// tauri-plugin-notification's init script asks for the notification permission at load (macOS, Linux); the webview
|
||||
// has no plugin API by design (capabilities/main.json), so that call is refused: expected, not an error
|
||||
function pluginProbe(e) { return /plugin:notification\|is_permission_granted not allowed/.test(text(e)); }
|
||||
window.addEventListener('unhandledrejection', function (ev) {
|
||||
if (pluginProbe(ev.reason)) { ev.preventDefault(); return; }
|
||||
if (!booted()) record('unhandledrejection', ev.reason, ev.reason && ev.reason.stack);
|
||||
});
|
||||
// React's root reports an error no boundary caught (the tree is gone) here: src/main.tsx onUncaughtError
|
||||
window.__storeboundBlank = function (message, stack) { record('react', message, stack); };
|
||||
// nothing drawn and nothing reported after a while: still say so
|
||||
window.addEventListener('load', function () {
|
||||
setTimeout(function () {
|
||||
if (!booted() && blank()) { errors.push('start: the window was still empty 15 s after loading'); invoke('log_webview', { level: 'error', message: 'start: the window was still empty 15 s after loading', detail: null }); show('storebound could not start', 'The window stayed empty while starting. Your app folders, store keys and saved data are untouched. Reload, or reset the saved state if it keeps happening, and copy the details into a bug report.'); }
|
||||
}, 15000);
|
||||
});
|
||||
})();
|
||||
153
apps/desktop/scripts/screens.ts
Normal file
|
|
@ -0,0 +1,153 @@
|
|||
#!/usr/bin/env bun
|
||||
// Screenshots of every desktop screen in light and dark, from the Vite dev server in fixture mode (no Tauri, no store
|
||||
// accounts), plus a few interaction checks (command palette, toast progress, keyboard focus). Dev tool only.
|
||||
// cd apps/desktop && VITE_FIXTURES=1 bunx vite --port 1431 &
|
||||
// bun scripts/screens.ts --base http://127.0.0.1:1431 --out <dir> [--only portfolio,app:health] [--themes light,dark]
|
||||
// Uses playwright (root devDependency) with the installed Google Chrome (channel "chrome").
|
||||
import { mkdirSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { chromium, type Page } from 'playwright';
|
||||
|
||||
const arg = (k: string, d: string) => { const i = process.argv.indexOf(`--${k}`); return i >= 0 ? process.argv[i + 1] ?? d : d; };
|
||||
const base = arg('base', 'http://127.0.0.1:1431');
|
||||
const out = arg('out', join(import.meta.dir, '..', '.screens'));
|
||||
const only = arg('only', '').split(',').filter(Boolean);
|
||||
const themes = arg('themes', 'light,dark').split(',');
|
||||
const lang = arg('lang', 'en');
|
||||
const suffix = arg('suffix', '');
|
||||
const prefix = arg('prefix', 'd3');
|
||||
|
||||
export const SCREENS: [string, string][] = [
|
||||
['portfolio', 'portfolio'], ['releases', 'app:releases'], ['releases-2', 'app:releases:2'], ['catalog', 'app:catalog'], ['listings', 'app:listings'],
|
||||
['health', 'app:health'], ['reviews', 'app:reviews'], ['testflight', 'app:testflight'], ['checks', 'app:checks'],
|
||||
['apps', 'apps'], ['accounts', 'accounts'], ['dependencies', 'dependencies'], ['settings', 'settings'],
|
||||
['ignored', 'ignored'], ['store-app', 'app:releases:3'], ['store-app-reviews', 'app:reviews:3'], ['store-app-single', 'app:releases:7'],
|
||||
['settings-pairing', 'settings:pairing'], ['settings-refresh', 'settings:refresh'], ['settings-privacy', 'settings:privacy'],
|
||||
['palette', 'palette'], ['welcome-1', 'welcome:1'], ['welcome-2', 'welcome:2'], ['welcome-3', 'welcome:3'], ['welcome-4', 'welcome:4'], ['welcome-5', 'welcome:5'],
|
||||
['welcome-6', 'welcome:6'], ['prices', 'app:prices'], ['art', 'app:art'], ['growth', 'app:growth'], ['growth-2', 'app:growth:2'], ['appinfo', 'app:appinfo'],
|
||||
['appinfo-2', 'app:appinfo:2'], ['store-app-growth', 'app:growth:3'],
|
||||
];
|
||||
|
||||
async function settle(page: Page) {
|
||||
await page.waitForLoadState('networkidle');
|
||||
await page.waitForTimeout(900);
|
||||
}
|
||||
|
||||
mkdirSync(out, { recursive: true });
|
||||
const browser = await chromium.launch({ channel: 'chrome', headless: true });
|
||||
const files: string[] = [];
|
||||
for (const theme of themes) {
|
||||
const ctx = await browser.newContext({ viewport: { width: 1440, height: 900 }, deviceScaleFactor: 1, colorScheme: theme === 'dark' ? 'dark' : 'light', reducedMotion: 'reduce' });
|
||||
const page = await ctx.newPage();
|
||||
const errors: string[] = [];
|
||||
page.on('pageerror', e => errors.push(String(e)));
|
||||
page.on('console', m => { if (m.type() === 'error') errors.push(m.text()); });
|
||||
for (const [name, start] of SCREENS) {
|
||||
if (only.length && !only.includes(name)) continue;
|
||||
await page.goto(`${base}/?start=${encodeURIComponent(start)}&theme=${theme}&lang=${lang}`);
|
||||
await settle(page);
|
||||
const f = join(out, `${prefix}-${name}${suffix}-${theme}${lang === 'en' ? '' : `-${lang}`}.png`);
|
||||
await page.screenshot({ path: f });
|
||||
files.push(f);
|
||||
}
|
||||
if (!only.length || only.includes('toast')) {
|
||||
// a background job: Read the stores, caught mid-way with its progress toast
|
||||
await page.goto(`${base}/?start=portfolio&theme=${theme}&lang=${lang}`);
|
||||
await settle(page);
|
||||
await page.getByRole('button', { name: /Read the stores|Mağazaları oku/ }).first().click();
|
||||
await page.waitForTimeout(900);
|
||||
const f = join(out, `${prefix}-toast${suffix}-${theme}${lang === 'en' ? '' : `-${lang}`}.png`);
|
||||
await page.screenshot({ path: f });
|
||||
files.push(f);
|
||||
}
|
||||
const shot = async (name: string) => {
|
||||
const f = join(out, `${prefix}-${name}${suffix}-${theme}${lang === 'en' ? '' : `-${lang}`}.png`);
|
||||
await page.screenshot({ path: f });
|
||||
files.push(f);
|
||||
};
|
||||
if (!only.length || only.includes('accounts-tested')) {
|
||||
// every account checked: one Play service account was never invited (permission missing, with the fix)
|
||||
await page.goto(`${base}/?start=accounts&theme=${theme}&lang=${lang}`);
|
||||
await settle(page);
|
||||
await page.getByRole('button', { name: /Test all accounts|Tüm hesapları sına/ }).click();
|
||||
await page.waitForTimeout(900);
|
||||
await page.getByText(/Sample Labs · Play/).first().scrollIntoViewIfNeeded();
|
||||
await page.evaluate(() => document.getElementById('content')?.scrollBy({ top: 260 }));
|
||||
await page.waitForTimeout(200);
|
||||
await shot('accounts-tested');
|
||||
}
|
||||
if (!only.length || only.includes('portfolio-filter')) {
|
||||
// one studio, sorted by name, no grouping, with a search
|
||||
await page.goto(`${base}/?start=portfolio&theme=${theme}&lang=${lang}`);
|
||||
await settle(page);
|
||||
await page.locator('.fchip', { hasText: 'Example Games' }).click();
|
||||
await page.getByPlaceholder(/Search apps|Uygulama, bundle/).fill('o');
|
||||
await page.waitForTimeout(300);
|
||||
await shot('portfolio-filter');
|
||||
await page.locator('.fchip').first().click();
|
||||
await page.getByPlaceholder(/Search apps|Uygulama, bundle/).fill('');
|
||||
}
|
||||
if (!only.length || only.includes('tf-edit')) {
|
||||
// TestFlight: What to Test editor of the newest build
|
||||
await page.goto(`${base}/?start=app:testflight&theme=${theme}&lang=${lang}`);
|
||||
await settle(page);
|
||||
await page.getByRole('button', { name: /What to Test|Neyi test etmeli/ }).first().click();
|
||||
await page.getByRole('textbox').first().fill('New combo meter and the calmer night palette. Please try level 31 at a 20x combo.');
|
||||
await page.waitForTimeout(200);
|
||||
await page.evaluate(() => document.getElementById('content')?.scrollBy({ top: 330 }));
|
||||
await page.waitForTimeout(200);
|
||||
await shot('tf-edit');
|
||||
}
|
||||
if (!only.length || only.includes('reply-edit')) {
|
||||
// Reviews: the reply editor of the approved draft, edited (not saved yet)
|
||||
await page.goto(`${base}/?start=app:reviews&theme=${theme}&lang=${lang}`);
|
||||
await settle(page);
|
||||
await page.locator('textarea.reply-edit').fill('Sorry about the lost streak! The fix for the crash at high combos is in 2.4.0, in review now. Thank you for the level number.');
|
||||
await page.waitForTimeout(200);
|
||||
await shot('reply-edit');
|
||||
}
|
||||
if (!only.length || only.includes('write-toast')) {
|
||||
// a write running: halt the Play rollout (owner action), caught with its progress toast
|
||||
await page.goto(`${base}/?start=app:releases&theme=${theme}&lang=${lang}`);
|
||||
await settle(page);
|
||||
await page.getByRole('button', { name: /^Halt$|^Durdur$/ }).first().click();
|
||||
await page.waitForTimeout(450);
|
||||
await shot('write-toast');
|
||||
}
|
||||
if (!only.length || only.includes('import')) {
|
||||
// Import apps running, with its progress toast
|
||||
await page.goto(`${base}/?start=accounts&theme=${theme}&lang=${lang}`);
|
||||
await settle(page);
|
||||
await page.getByRole('button', { name: /^Import apps$|^Uygulamaları içe aktar$/ }).first().click();
|
||||
await page.waitForTimeout(700);
|
||||
await shot('import');
|
||||
}
|
||||
if (!only.length || only.includes('prices-diff')) {
|
||||
// a price sheet compared with the stores, with the owner's Apply
|
||||
await page.goto(`${base}/?start=app:prices&theme=${theme}&lang=${lang}`);
|
||||
await settle(page);
|
||||
await page.getByRole('button', { name: /Compare store\/prices.csv|store\/prices.csv karşılaştır/ }).click();
|
||||
await page.waitForTimeout(1500);
|
||||
await shot('prices-diff');
|
||||
}
|
||||
if (!only.length || only.includes('export-menu')) {
|
||||
// the top-right Export menu of a screen
|
||||
await page.goto(`${base}/?start=app:reviews&theme=${theme}&lang=${lang}`);
|
||||
await settle(page);
|
||||
await page.getByRole('button', { name: /^Export$|^Dışa aktar$/ }).click();
|
||||
await page.waitForTimeout(300);
|
||||
await shot('export-menu');
|
||||
}
|
||||
if (!only.length || only.includes('art-lightbox')) {
|
||||
// one render opened large
|
||||
await page.goto(`${base}/?start=app:art&theme=${theme}&lang=${lang}`);
|
||||
await settle(page);
|
||||
await page.locator('.art-pic').first().click();
|
||||
await page.waitForTimeout(500);
|
||||
await shot('art-lightbox');
|
||||
}
|
||||
if (errors.length) console.error(`${theme}: page errors:\n ${[...new Set(errors)].join('\n ')}`);
|
||||
await ctx.close();
|
||||
}
|
||||
await browser.close();
|
||||
console.log(files.join('\n'));
|
||||
6367
apps/desktop/src-tauri/Cargo.lock
generated
Normal file
70
apps/desktop/src-tauri/Cargo.toml
Normal file
|
|
@ -0,0 +1,70 @@
|
|||
[package]
|
||||
name = "storebound-desktop"
|
||||
version = "0.8.78"
|
||||
description = "storebound desktop: every game's releases on both stores in one window"
|
||||
license = "MIT"
|
||||
edition = "2021"
|
||||
rust-version = "1.85"
|
||||
publish = false
|
||||
|
||||
[lib]
|
||||
name = "storebound_desktop"
|
||||
path = "src/lib.rs"
|
||||
|
||||
[[bin]]
|
||||
name = "storebound-desktop"
|
||||
path = "src/main.rs"
|
||||
|
||||
[build-dependencies]
|
||||
tauri-build = { version = "2", features = [] }
|
||||
|
||||
[dependencies]
|
||||
tauri = { version = "2.12", features = ["tray-icon"] }
|
||||
# Spawns the storebound sidecar from Rust only; no capability grants the plugin's JS API.
|
||||
tauri-plugin-shell = "2"
|
||||
tauri-plugin-single-instance = { version = "2", features = ["deep-link"] }
|
||||
tauri-plugin-deep-link = "2"
|
||||
tauri-plugin-window-state = "2"
|
||||
# Opener, dialog, notification, updater and process are driven from Rust only (no JS permissions).
|
||||
tauri-plugin-opener = "2"
|
||||
tauri-plugin-dialog = "2"
|
||||
tauri-plugin-notification = "2"
|
||||
tauri-plugin-updater = "2"
|
||||
tauri-plugin-process = "2"
|
||||
tauri-plugin-autostart = "2"
|
||||
# Store credentials: macOS Keychain, Windows Credential Manager, Secret Service on Linux.
|
||||
keyring = { version = "3", features = ["apple-native", "windows-native", "sync-secret-service", "crypto-rust"] }
|
||||
serde = { version = "1", features = ["derive"] }
|
||||
serde_json = "1"
|
||||
hmac = "0.12"
|
||||
sha2 = "0.10"
|
||||
base64 = "0.22"
|
||||
getrandom = "0.3"
|
||||
url = "2"
|
||||
tokio = { version = "1", features = ["sync", "time"] }
|
||||
# Offline cache of the last store reads (app data cache.sqlite); SQLite compiled in, nothing system-wide.
|
||||
rusqlite = { version = "0.38", features = ["bundled"] }
|
||||
# Dependencies screen downloads (ffmpeg, Chrome for Testing): the same HTTP stack the updater already brings.
|
||||
reqwest = { version = "0.13", default-features = false, features = ["rustls-no-provider", "system-proxy"] }
|
||||
rustls = { version = "0.23", default-features = false, features = ["ring", "std", "tls12"] }
|
||||
zip = { version = "4", default-features = false, features = ["deflate-flate2-zlib-rs"] }
|
||||
|
||||
# Release builds turn off WebView2's browser context menu and accelerator keys (Back, Refresh, Print, Save as).
|
||||
[target.'cfg(windows)'.dependencies]
|
||||
webview2-com = "0.39"
|
||||
windows-core = "0.62"
|
||||
# reads Startup apps' StartupApproved value (already in the tree through the autostart plugin)
|
||||
winreg = "0.56"
|
||||
|
||||
[dev-dependencies]
|
||||
tempfile = "3"
|
||||
|
||||
[profile.release]
|
||||
codegen-units = 1
|
||||
lto = true
|
||||
opt-level = "s"
|
||||
panic = "abort"
|
||||
strip = true
|
||||
|
||||
[target.'cfg(unix)'.dependencies]
|
||||
libc = "0.2"
|
||||
11
apps/desktop/src-tauri/build.rs
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
// App command manifest: every #[tauri::command] gets an `allow-<name>` permission, and a command no capability lists
|
||||
// is denied. The list lives in src/commands_list.rs so tests/security.rs can compare it with the capability files.
|
||||
include!("src/commands_list.rs");
|
||||
|
||||
fn main() {
|
||||
tauri_build::try_build(
|
||||
tauri_build::Attributes::new()
|
||||
.app_manifest(tauri_build::AppManifest::new().commands(Box::leak([COMMANDS, CARD_COMMANDS, MENU_COMMANDS].concat().into_boxed_slice()))),
|
||||
)
|
||||
.expect("tauri build script failed");
|
||||
}
|
||||
13
apps/desktop/src-tauri/capabilities/card.json
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
{
|
||||
"$schema": "../gen/schemas/desktop-schema.json",
|
||||
"identifier": "card-window",
|
||||
"description": "The tray card (a small window next to the tray icon) with the app's own bundled card page only. It may listen to app events (the main window's snapshot) and call the two card commands: read the last snapshot and send a button (hide, open the main window or a route in it, refresh and mute through the main window, open a store console, quit). It never reads the stores or reaches the sidecar; every command re-checks the window label and page origin in Rust.",
|
||||
"windows": ["card"],
|
||||
"local": true,
|
||||
"permissions": [
|
||||
"core:event:allow-listen",
|
||||
"core:event:allow-unlisten",
|
||||
"allow-card-get",
|
||||
"allow-card-action"
|
||||
]
|
||||
}
|
||||
64
apps/desktop/src-tauri/capabilities/main.json
Normal file
|
|
@ -0,0 +1,64 @@
|
|||
{
|
||||
"$schema": "../gen/schemas/desktop-schema.json",
|
||||
"identifier": "main-window",
|
||||
"description": "The main window with the app's own bundled pages only (no remote content). It may listen to app events (sidecar progress, tool downloads, deep links) and call the storebound app commands; every command re-checks the window label and page origin in Rust. No plugin API is granted to the webview: the sidecar is spawned from Rust with fixed arguments, dialogs, the opener, notifications, the updater and process control are driven from Rust only, and credentials never reach the page.",
|
||||
"windows": [
|
||||
"main"
|
||||
],
|
||||
"local": true,
|
||||
"permissions": [
|
||||
"core:event:allow-listen",
|
||||
"core:event:allow-unlisten",
|
||||
"allow-app-info",
|
||||
"allow-sidecar-status",
|
||||
"allow-sidecar-call",
|
||||
"allow-cache-get",
|
||||
"allow-cache-clear",
|
||||
"allow-job-cancel",
|
||||
"allow-write-with-confirm",
|
||||
"allow-projects-list",
|
||||
"allow-project-add",
|
||||
"allow-project-init",
|
||||
"allow-project-remove",
|
||||
"allow-project-set-accounts",
|
||||
"allow-accounts-list",
|
||||
"allow-account-add-play",
|
||||
"allow-account-add-apple",
|
||||
"allow-account-remove",
|
||||
"allow-portfolio-status",
|
||||
"allow-open-external",
|
||||
"allow-tools-info",
|
||||
"allow-tools-install",
|
||||
"allow-tools-uninstall",
|
||||
"allow-workspace-get",
|
||||
"allow-studio-save",
|
||||
"allow-studio-remove",
|
||||
"allow-studio-logo",
|
||||
"allow-account-update",
|
||||
"allow-account-set-play-developer",
|
||||
"allow-account-check",
|
||||
"allow-store-apps-refresh",
|
||||
"allow-store-apps-cached",
|
||||
"allow-overrides-set",
|
||||
"allow-settings-set",
|
||||
"allow-cache-info",
|
||||
"allow-data-reveal",
|
||||
"allow-notify",
|
||||
"allow-tray-update",
|
||||
"allow-card-snapshot",
|
||||
"allow-app-reset",
|
||||
"allow-update-check",
|
||||
"allow-update-install",
|
||||
"allow-project-import-fastlane",
|
||||
"allow-export-save",
|
||||
"allow-price-sheet-pick",
|
||||
"allow-image-pick",
|
||||
"allow-project-reveal",
|
||||
"allow-project-locate",
|
||||
"allow-state-reset",
|
||||
"allow-log-webview",
|
||||
"allow-ai-fix-info",
|
||||
"allow-ai-fix-run",
|
||||
"allow-ai-fix-undo"
|
||||
]
|
||||
}
|
||||
21
apps/desktop/src-tauri/capabilities/menu.json
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"$schema": "../gen/schemas/desktop-schema.json",
|
||||
"identifier": "menu-window",
|
||||
"description": "The tray menu panels (menu-1, menu-2...: small frameless windows the app opens on a right click on the tray icon, one per open or pinned submenu) with the app's own bundled tray-menu page only. They may listen to app events (the live menu tree) and call the menu commands: read their panel, report their size, open, pin and close panels, pick a row, which runs the same tray action as the native menu, and start a drag of their own window (a pinned panel's header). They never read the stores or reach the sidecar; every command re-checks the window label and page origin in Rust.",
|
||||
"windows": ["menu-*"],
|
||||
"local": true,
|
||||
"permissions": [
|
||||
"core:event:allow-listen",
|
||||
"core:event:allow-unlisten",
|
||||
"core:window:allow-start-dragging",
|
||||
"allow-menu-state",
|
||||
"allow-menu-ready",
|
||||
"allow-menu-open-sub",
|
||||
"allow-menu-pin-sub",
|
||||
"allow-menu-close-subs",
|
||||
"allow-menu-close",
|
||||
"allow-menu-dismiss",
|
||||
"allow-menu-pin",
|
||||
"allow-menu-select"
|
||||
]
|
||||
}
|
||||
13
apps/desktop/src-tauri/entitlements.plist
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||
<!-- Hardened runtime entitlements of the Developer ID build (tools/desktop-release.ts). Tauri signs the app and the
|
||||
bundled CLI sidecar with the same file; the sidecar is a Bun single-file executable whose JavaScriptCore
|
||||
JIT needs these two. Nothing else is granted (no library validation exceptions, no sandbox escapes). -->
|
||||
<plist version="1.0">
|
||||
<dict>
|
||||
<key>com.apple.security.cs.allow-jit</key>
|
||||
<true/>
|
||||
<key>com.apple.security.cs.allow-unsigned-executable-memory</key>
|
||||
<true/>
|
||||
</dict>
|
||||
</plist>
|
||||
BIN
apps/desktop/src-tauri/icons/128x128.png
Normal file
|
After Width: | Height: | Size: 22 KiB |
BIN
apps/desktop/src-tauri/icons/128x128@2x.png
Normal file
|
After Width: | Height: | Size: 69 KiB |
BIN
apps/desktop/src-tauri/icons/256x256.png
Normal file
|
After Width: | Height: | Size: 69 KiB |
BIN
apps/desktop/src-tauri/icons/32x32.png
Normal file
|
After Width: | Height: | Size: 2.4 KiB |
BIN
apps/desktop/src-tauri/icons/64x64.png
Normal file
|
After Width: | Height: | Size: 7.3 KiB |
BIN
apps/desktop/src-tauri/icons/Square107x107Logo.png
Normal file
|
After Width: | Height: | Size: 16 KiB |
BIN
apps/desktop/src-tauri/icons/Square142x142Logo.png
Normal file
|
After Width: | Height: | Size: 25 KiB |
BIN
apps/desktop/src-tauri/icons/Square150x150Logo.png
Normal file
|
After Width: | Height: | Size: 27 KiB |
BIN
apps/desktop/src-tauri/icons/Square284x284Logo.png
Normal file
|
After Width: | Height: | Size: 77 KiB |
BIN
apps/desktop/src-tauri/icons/Square30x30Logo.png
Normal file
|
After Width: | Height: | Size: 2 KiB |
BIN
apps/desktop/src-tauri/icons/Square310x310Logo.png
Normal file
|
After Width: | Height: | Size: 89 KiB |
BIN
apps/desktop/src-tauri/icons/Square44x44Logo.png
Normal file
|
After Width: | Height: | Size: 3.7 KiB |
BIN
apps/desktop/src-tauri/icons/Square71x71Logo.png
Normal file
|
After Width: | Height: | Size: 8.1 KiB |
BIN
apps/desktop/src-tauri/icons/Square89x89Logo.png
Normal file
|
After Width: | Height: | Size: 12 KiB |
BIN
apps/desktop/src-tauri/icons/StoreLogo.png
Normal file
|
After Width: | Height: | Size: 4.6 KiB |
BIN
apps/desktop/src-tauri/icons/icon.icns
Normal file
BIN
apps/desktop/src-tauri/icons/icon.ico
Normal file
|
After Width: | Height: | Size: 158 KiB |
BIN
apps/desktop/src-tauri/icons/icon.png
Normal file
|
After Width: | Height: | Size: 228 KiB |
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-account-add-apple"
|
||||
description = "Enables the account_add_apple command without any pre-configured scope."
|
||||
commands.allow = ["account_add_apple"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-account-add-apple"
|
||||
description = "Denies the account_add_apple command without any pre-configured scope."
|
||||
commands.deny = ["account_add_apple"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-account-add-play"
|
||||
description = "Enables the account_add_play command without any pre-configured scope."
|
||||
commands.allow = ["account_add_play"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-account-add-play"
|
||||
description = "Denies the account_add_play command without any pre-configured scope."
|
||||
commands.deny = ["account_add_play"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-account-check"
|
||||
description = "Enables the account_check command without any pre-configured scope."
|
||||
commands.allow = ["account_check"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-account-check"
|
||||
description = "Denies the account_check command without any pre-configured scope."
|
||||
commands.deny = ["account_check"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-account-remove"
|
||||
description = "Enables the account_remove command without any pre-configured scope."
|
||||
commands.allow = ["account_remove"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-account-remove"
|
||||
description = "Denies the account_remove command without any pre-configured scope."
|
||||
commands.deny = ["account_remove"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-account-set-play-developer"
|
||||
description = "Enables the account_set_play_developer command without any pre-configured scope."
|
||||
commands.allow = ["account_set_play_developer"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-account-set-play-developer"
|
||||
description = "Denies the account_set_play_developer command without any pre-configured scope."
|
||||
commands.deny = ["account_set_play_developer"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-account-update"
|
||||
description = "Enables the account_update command without any pre-configured scope."
|
||||
commands.allow = ["account_update"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-account-update"
|
||||
description = "Denies the account_update command without any pre-configured scope."
|
||||
commands.deny = ["account_update"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-accounts-list"
|
||||
description = "Enables the accounts_list command without any pre-configured scope."
|
||||
commands.allow = ["accounts_list"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-accounts-list"
|
||||
description = "Denies the accounts_list command without any pre-configured scope."
|
||||
commands.deny = ["accounts_list"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-ai-fix-info"
|
||||
description = "Enables the ai_fix_info command without any pre-configured scope."
|
||||
commands.allow = ["ai_fix_info"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-ai-fix-info"
|
||||
description = "Denies the ai_fix_info command without any pre-configured scope."
|
||||
commands.deny = ["ai_fix_info"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-ai-fix-run"
|
||||
description = "Enables the ai_fix_run command without any pre-configured scope."
|
||||
commands.allow = ["ai_fix_run"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-ai-fix-run"
|
||||
description = "Denies the ai_fix_run command without any pre-configured scope."
|
||||
commands.deny = ["ai_fix_run"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-ai-fix-undo"
|
||||
description = "Enables the ai_fix_undo command without any pre-configured scope."
|
||||
commands.allow = ["ai_fix_undo"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-ai-fix-undo"
|
||||
description = "Denies the ai_fix_undo command without any pre-configured scope."
|
||||
commands.deny = ["ai_fix_undo"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-app-info"
|
||||
description = "Enables the app_info command without any pre-configured scope."
|
||||
commands.allow = ["app_info"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-app-info"
|
||||
description = "Denies the app_info command without any pre-configured scope."
|
||||
commands.deny = ["app_info"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-app-reset"
|
||||
description = "Enables the app_reset command without any pre-configured scope."
|
||||
commands.allow = ["app_reset"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-app-reset"
|
||||
description = "Denies the app_reset command without any pre-configured scope."
|
||||
commands.deny = ["app_reset"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-cache-clear"
|
||||
description = "Enables the cache_clear command without any pre-configured scope."
|
||||
commands.allow = ["cache_clear"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-cache-clear"
|
||||
description = "Denies the cache_clear command without any pre-configured scope."
|
||||
commands.deny = ["cache_clear"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-cache-get"
|
||||
description = "Enables the cache_get command without any pre-configured scope."
|
||||
commands.allow = ["cache_get"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-cache-get"
|
||||
description = "Denies the cache_get command without any pre-configured scope."
|
||||
commands.deny = ["cache_get"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-cache-info"
|
||||
description = "Enables the cache_info command without any pre-configured scope."
|
||||
commands.allow = ["cache_info"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-cache-info"
|
||||
description = "Denies the cache_info command without any pre-configured scope."
|
||||
commands.deny = ["cache_info"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-card-action"
|
||||
description = "Enables the card_action command without any pre-configured scope."
|
||||
commands.allow = ["card_action"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-card-action"
|
||||
description = "Denies the card_action command without any pre-configured scope."
|
||||
commands.deny = ["card_action"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-card-get"
|
||||
description = "Enables the card_get command without any pre-configured scope."
|
||||
commands.allow = ["card_get"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-card-get"
|
||||
description = "Denies the card_get command without any pre-configured scope."
|
||||
commands.deny = ["card_get"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-card-snapshot"
|
||||
description = "Enables the card_snapshot command without any pre-configured scope."
|
||||
commands.allow = ["card_snapshot"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-card-snapshot"
|
||||
description = "Denies the card_snapshot command without any pre-configured scope."
|
||||
commands.deny = ["card_snapshot"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-data-reveal"
|
||||
description = "Enables the data_reveal command without any pre-configured scope."
|
||||
commands.allow = ["data_reveal"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-data-reveal"
|
||||
description = "Denies the data_reveal command without any pre-configured scope."
|
||||
commands.deny = ["data_reveal"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-export-save"
|
||||
description = "Enables the export_save command without any pre-configured scope."
|
||||
commands.allow = ["export_save"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-export-save"
|
||||
description = "Denies the export_save command without any pre-configured scope."
|
||||
commands.deny = ["export_save"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-image-pick"
|
||||
description = "Enables the image_pick command without any pre-configured scope."
|
||||
commands.allow = ["image_pick"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-image-pick"
|
||||
description = "Denies the image_pick command without any pre-configured scope."
|
||||
commands.deny = ["image_pick"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-job-cancel"
|
||||
description = "Enables the job_cancel command without any pre-configured scope."
|
||||
commands.allow = ["job_cancel"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-job-cancel"
|
||||
description = "Denies the job_cancel command without any pre-configured scope."
|
||||
commands.deny = ["job_cancel"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-log-webview"
|
||||
description = "Enables the log_webview command without any pre-configured scope."
|
||||
commands.allow = ["log_webview"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-log-webview"
|
||||
description = "Denies the log_webview command without any pre-configured scope."
|
||||
commands.deny = ["log_webview"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-menu-close"
|
||||
description = "Enables the menu_close command without any pre-configured scope."
|
||||
commands.allow = ["menu_close"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-menu-close"
|
||||
description = "Denies the menu_close command without any pre-configured scope."
|
||||
commands.deny = ["menu_close"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-menu-close-subs"
|
||||
description = "Enables the menu_close_subs command without any pre-configured scope."
|
||||
commands.allow = ["menu_close_subs"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-menu-close-subs"
|
||||
description = "Denies the menu_close_subs command without any pre-configured scope."
|
||||
commands.deny = ["menu_close_subs"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-menu-dismiss"
|
||||
description = "Enables the menu_dismiss command without any pre-configured scope."
|
||||
commands.allow = ["menu_dismiss"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-menu-dismiss"
|
||||
description = "Denies the menu_dismiss command without any pre-configured scope."
|
||||
commands.deny = ["menu_dismiss"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-menu-open-sub"
|
||||
description = "Enables the menu_open_sub command without any pre-configured scope."
|
||||
commands.allow = ["menu_open_sub"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-menu-open-sub"
|
||||
description = "Denies the menu_open_sub command without any pre-configured scope."
|
||||
commands.deny = ["menu_open_sub"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-menu-pin"
|
||||
description = "Enables the menu_pin command without any pre-configured scope."
|
||||
commands.allow = ["menu_pin"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-menu-pin"
|
||||
description = "Denies the menu_pin command without any pre-configured scope."
|
||||
commands.deny = ["menu_pin"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-menu-pin-sub"
|
||||
description = "Enables the menu_pin_sub command without any pre-configured scope."
|
||||
commands.allow = ["menu_pin_sub"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-menu-pin-sub"
|
||||
description = "Denies the menu_pin_sub command without any pre-configured scope."
|
||||
commands.deny = ["menu_pin_sub"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-menu-ready"
|
||||
description = "Enables the menu_ready command without any pre-configured scope."
|
||||
commands.allow = ["menu_ready"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-menu-ready"
|
||||
description = "Denies the menu_ready command without any pre-configured scope."
|
||||
commands.deny = ["menu_ready"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-menu-select"
|
||||
description = "Enables the menu_select command without any pre-configured scope."
|
||||
commands.allow = ["menu_select"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-menu-select"
|
||||
description = "Denies the menu_select command without any pre-configured scope."
|
||||
commands.deny = ["menu_select"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-menu-state"
|
||||
description = "Enables the menu_state command without any pre-configured scope."
|
||||
commands.allow = ["menu_state"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-menu-state"
|
||||
description = "Denies the menu_state command without any pre-configured scope."
|
||||
commands.deny = ["menu_state"]
|
||||
11
apps/desktop/src-tauri/permissions/autogenerated/notify.toml
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-notify"
|
||||
description = "Enables the notify command without any pre-configured scope."
|
||||
commands.allow = ["notify"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-notify"
|
||||
description = "Denies the notify command without any pre-configured scope."
|
||||
commands.deny = ["notify"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-open-external"
|
||||
description = "Enables the open_external command without any pre-configured scope."
|
||||
commands.allow = ["open_external"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-open-external"
|
||||
description = "Denies the open_external command without any pre-configured scope."
|
||||
commands.deny = ["open_external"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-overrides-set"
|
||||
description = "Enables the overrides_set command without any pre-configured scope."
|
||||
commands.allow = ["overrides_set"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-overrides-set"
|
||||
description = "Denies the overrides_set command without any pre-configured scope."
|
||||
commands.deny = ["overrides_set"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-portfolio-status"
|
||||
description = "Enables the portfolio_status command without any pre-configured scope."
|
||||
commands.allow = ["portfolio_status"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-portfolio-status"
|
||||
description = "Denies the portfolio_status command without any pre-configured scope."
|
||||
commands.deny = ["portfolio_status"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-price-sheet-pick"
|
||||
description = "Enables the price_sheet_pick command without any pre-configured scope."
|
||||
commands.allow = ["price_sheet_pick"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-price-sheet-pick"
|
||||
description = "Denies the price_sheet_pick command without any pre-configured scope."
|
||||
commands.deny = ["price_sheet_pick"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-project-add"
|
||||
description = "Enables the project_add command without any pre-configured scope."
|
||||
commands.allow = ["project_add"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-project-add"
|
||||
description = "Denies the project_add command without any pre-configured scope."
|
||||
commands.deny = ["project_add"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-project-import-fastlane"
|
||||
description = "Enables the project_import_fastlane command without any pre-configured scope."
|
||||
commands.allow = ["project_import_fastlane"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-project-import-fastlane"
|
||||
description = "Denies the project_import_fastlane command without any pre-configured scope."
|
||||
commands.deny = ["project_import_fastlane"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-project-init"
|
||||
description = "Enables the project_init command without any pre-configured scope."
|
||||
commands.allow = ["project_init"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-project-init"
|
||||
description = "Denies the project_init command without any pre-configured scope."
|
||||
commands.deny = ["project_init"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-project-locate"
|
||||
description = "Enables the project_locate command without any pre-configured scope."
|
||||
commands.allow = ["project_locate"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-project-locate"
|
||||
description = "Denies the project_locate command without any pre-configured scope."
|
||||
commands.deny = ["project_locate"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-project-remove"
|
||||
description = "Enables the project_remove command without any pre-configured scope."
|
||||
commands.allow = ["project_remove"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-project-remove"
|
||||
description = "Denies the project_remove command without any pre-configured scope."
|
||||
commands.deny = ["project_remove"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-project-reveal"
|
||||
description = "Enables the project_reveal command without any pre-configured scope."
|
||||
commands.allow = ["project_reveal"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-project-reveal"
|
||||
description = "Denies the project_reveal command without any pre-configured scope."
|
||||
commands.deny = ["project_reveal"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-project-set-accounts"
|
||||
description = "Enables the project_set_accounts command without any pre-configured scope."
|
||||
commands.allow = ["project_set_accounts"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-project-set-accounts"
|
||||
description = "Denies the project_set_accounts command without any pre-configured scope."
|
||||
commands.deny = ["project_set_accounts"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-projects-list"
|
||||
description = "Enables the projects_list command without any pre-configured scope."
|
||||
commands.allow = ["projects_list"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-projects-list"
|
||||
description = "Denies the projects_list command without any pre-configured scope."
|
||||
commands.deny = ["projects_list"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-settings-set"
|
||||
description = "Enables the settings_set command without any pre-configured scope."
|
||||
commands.allow = ["settings_set"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-settings-set"
|
||||
description = "Denies the settings_set command without any pre-configured scope."
|
||||
commands.deny = ["settings_set"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-sidecar-call"
|
||||
description = "Enables the sidecar_call command without any pre-configured scope."
|
||||
commands.allow = ["sidecar_call"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-sidecar-call"
|
||||
description = "Denies the sidecar_call command without any pre-configured scope."
|
||||
commands.deny = ["sidecar_call"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-sidecar-status"
|
||||
description = "Enables the sidecar_status command without any pre-configured scope."
|
||||
commands.allow = ["sidecar_status"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-sidecar-status"
|
||||
description = "Denies the sidecar_status command without any pre-configured scope."
|
||||
commands.deny = ["sidecar_status"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-state-reset"
|
||||
description = "Enables the state_reset command without any pre-configured scope."
|
||||
commands.allow = ["state_reset"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-state-reset"
|
||||
description = "Denies the state_reset command without any pre-configured scope."
|
||||
commands.deny = ["state_reset"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-store-apps-cached"
|
||||
description = "Enables the store_apps_cached command without any pre-configured scope."
|
||||
commands.allow = ["store_apps_cached"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-store-apps-cached"
|
||||
description = "Denies the store_apps_cached command without any pre-configured scope."
|
||||
commands.deny = ["store_apps_cached"]
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
# Automatically generated - DO NOT EDIT!
|
||||
|
||||
[[permission]]
|
||||
identifier = "allow-store-apps-refresh"
|
||||
description = "Enables the store_apps_refresh command without any pre-configured scope."
|
||||
commands.allow = ["store_apps_refresh"]
|
||||
|
||||
[[permission]]
|
||||
identifier = "deny-store-apps-refresh"
|
||||
description = "Denies the store_apps_refresh command without any pre-configured scope."
|
||||
commands.deny = ["store_apps_refresh"]
|
||||