Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
eb426b84a2 | ||
|
|
0502947701 | ||
|
|
a551e57ca1 | ||
|
|
ec1bf939f6 | ||
|
|
d482013cf7 | ||
|
|
496643c16c | ||
|
|
53fa5957ea | ||
|
|
3f05d9fc45 | ||
|
|
2e28d44885 | ||
|
|
c9e133d3ef | ||
|
|
55fcf1342a | ||
|
|
11c38dba24 | ||
|
|
a956c8e182 | ||
|
|
629cb1df75 | ||
|
|
d87bf4e2e6 | ||
|
|
810325d615 | ||
|
|
8cee0386b8 | ||
|
|
b5d49d27ef | ||
|
|
fa2d08d9c7 | ||
|
|
754432be7d | ||
|
|
40e7e65a8a | ||
|
|
005f923c4f | ||
|
|
de59ad8780 | ||
|
|
8b70220247 | ||
|
|
79e0fe0379 | ||
|
|
8c8a0d703c | ||
|
|
6bd060b85c | ||
|
|
aec8524b3d | ||
|
|
338c7f5346 | ||
|
|
e9569b6f59 | ||
|
|
38e0e1941b | ||
|
|
11e7776ddb | ||
|
|
cabc925381 | ||
|
|
516946e140 | ||
|
|
6e6425dde4 | ||
|
|
3eb88db76d | ||
|
|
9a68f5b0cd | ||
|
|
1ed30cc15c | ||
|
|
8ef4a3ed79 | ||
|
|
943dddcc71 | ||
|
|
6868b7062c | ||
|
|
87693dacd8 | ||
|
|
bb179a953d | ||
|
|
37e52ebc63 | ||
|
|
3eba2c74e0 | ||
|
|
8b0d069c3e | ||
|
|
a739b3f56e | ||
|
|
c9fd7d12ff | ||
|
|
987ed4c01d | ||
|
|
a91952e602 | ||
|
|
98e0350a8b | ||
|
|
7d27261e5b | ||
|
|
815b979e57 | ||
|
|
9d82fb1645 | ||
|
|
86d197d615 | ||
|
|
9e5abacc52 | ||
|
|
18fafbffe8 | ||
|
|
b95e9a733e | ||
|
|
06e15dfd7d | ||
|
|
3d074a9aab | ||
|
|
1e78af5121 | ||
|
|
d6107ea986 | ||
|
|
6e6df6db4f | ||
|
|
da25638a76 | ||
|
|
4cf7871eb7 | ||
|
|
4b1d916274 | ||
|
|
0e64b5fa51 | ||
|
|
e2162ef881 | ||
|
|
3e945c72ab | ||
|
|
b193f2b8cf | ||
|
|
cee8483a2d | ||
|
|
94a0084fc7 | ||
|
|
871a3d548b | ||
|
|
27747be1ab | ||
|
|
fa8dbaf92b | ||
|
|
6c7c6e844e | ||
|
|
d3fea36da1 | ||
|
|
f379690ade | ||
|
|
4ef293abbf | ||
|
|
69707cebd7 | ||
|
|
912ced10c1 | ||
|
|
5d69cd63d4 | ||
|
|
a9eee8ea37 | ||
|
|
5f95e71028 | ||
|
|
fcd15d9dc6 | ||
|
|
4df740762b | ||
|
|
527e8c9ae0 | ||
|
|
45cafb9229 | ||
|
|
cd9fa3f3fb | ||
|
|
2999d00f1e | ||
|
|
e85c0b7c3d | ||
|
|
5f5d5aaacb | ||
|
|
b1b5cdbaf6 | ||
|
|
c110fae122 | ||
|
|
72dcf09f0d | ||
|
|
be48842a48 | ||
|
|
e7c9d05e7c | ||
|
|
e9ee8e0dbb | ||
|
|
f989fa08b8 | ||
|
|
7e1db40c37 | ||
|
|
06a79264a5 | ||
|
|
658e6c854a | ||
|
|
1cdce944ff | ||
|
|
0789f9041f | ||
|
|
7092925a42 | ||
|
|
f16ef68269 | ||
|
|
3830208e40 | ||
|
|
4926c7ea00 | ||
|
|
91f49d2cef | ||
|
|
24fa8554e2 | ||
|
|
946d097c56 | ||
|
|
3423500494 | ||
|
|
e827ac83a7 | ||
|
|
0f68351fb8 | ||
|
|
a858c6ed20 | ||
|
|
2b4b988cc7 | ||
|
|
1845834b98 | ||
|
|
b5b8b4eb12 | ||
|
|
fc201981de | ||
|
|
5308f7b5ab | ||
|
|
1c7afb773f | ||
|
|
09bbbaa449 | ||
|
|
2dea52dd25 | ||
|
|
20490e2dab | ||
|
|
bb0e225565 | ||
|
|
c1707a858d | ||
|
|
77109032f4 | ||
|
|
d94500bd29 | ||
|
|
bf0a075d4e | ||
|
|
a7fce4ad1c | ||
|
|
453e7fafeb | ||
|
|
516658c24f | ||
|
|
bc117131e9 | ||
|
|
3f107e12d4 | ||
|
|
745f26fc54 | ||
|
|
4fb66516f3 | ||
|
|
3d2b5567d9 | ||
|
|
6907c44877 | ||
|
|
8c84a686f5 | ||
|
|
7261c937db | ||
|
|
f31d058ae3 | ||
|
|
7d0a37f0df | ||
|
|
ac89daad0b | ||
|
|
11d5c06177 | ||
|
|
944918f93a | ||
|
|
7d82773873 | ||
|
|
a9e34770c9 | ||
|
|
9d8926c7d3 | ||
|
|
8bbc654447 | ||
|
|
997e29952a | ||
|
|
eec68b92d1 | ||
|
|
e27ab05d5d | ||
|
|
e3d47103a6 | ||
|
|
98d908c44c | ||
|
|
7b79ade258 | ||
|
|
1c00bc31a8 | ||
|
|
6fd15af40a | ||
|
|
c127a80e83 | ||
|
|
636a355b84 | ||
|
|
462e42f562 | ||
|
|
ff11c14515 | ||
|
|
ed36ec0958 | ||
|
|
50490129c1 | ||
|
|
46dcd75042 | ||
|
|
aff9b1832b | ||
|
|
48b3781ca2 | ||
|
|
c544317cbb | ||
|
|
42907665f0 | ||
|
|
e5e1acfaa5 | ||
|
|
092593c1ad | ||
|
|
7eba1d477d | ||
|
|
5e03fcf595 | ||
|
|
b566610751 | ||
|
|
7932220e10 | ||
|
|
0e4bd8f9d6 | ||
|
|
7ffcb1355c | ||
|
|
efb4c52b05 | ||
|
|
ec4996d070 | ||
|
|
81a0ed8ca2 | ||
|
|
25396fa380 | ||
|
|
45cfbc702b | ||
|
|
576180b9c0 | ||
|
|
146f513431 | ||
|
|
e5a7c67e7c | ||
|
|
7277e061dc | ||
|
|
be4ae3cd7d | ||
|
|
6c34c09fc1 | ||
|
|
f284258e9c | ||
|
|
37e6c75edf | ||
|
|
bf57ef4afa | ||
|
|
a2b1269b08 | ||
|
|
794890350f | ||
|
|
7654949ef5 | ||
|
|
0e4dd40873 | ||
|
|
209e20f13e | ||
|
|
ec73dc84f8 | ||
|
|
15e715d19f | ||
|
|
96faa3c63f | ||
|
|
6d5fca0f50 | ||
|
|
382d33e881 | ||
|
|
009dc03cea | ||
|
|
8128d3177b | ||
|
|
c51c74ef14 | ||
|
|
f3476ae9e4 | ||
|
|
2b339df9bb | ||
|
|
adb08a4301 | ||
|
|
ce2e1e014b | ||
|
|
b6e45d86ef | ||
|
|
4c987036e2 | ||
|
|
5981c24bcd | ||
|
|
69c8964842 | ||
|
|
751898ed08 | ||
|
|
cbf87cb5c3 | ||
|
|
4140caa9df | ||
|
|
73866bfccb | ||
|
|
f8607ac189 | ||
|
|
a94ed09c6a | ||
|
|
d11fd4e0bf | ||
|
|
94c7235de9 | ||
|
|
42d1008086 | ||
|
|
bc4415a715 | ||
|
|
5fc6659395 | ||
|
|
9091ea56d1 | ||
|
|
94ab4cb180 | ||
|
|
c68dba6ca0 | ||
|
|
ab8a6562b6 | ||
|
|
b7a9456afe | ||
|
|
3b5058c854 | ||
|
|
808461198a | ||
|
|
d61ca134f2 | ||
|
|
4ec4b15306 | ||
|
|
601083a061 | ||
|
|
fd55963681 | ||
|
|
6baf4d3f24 | ||
|
|
8cb5f1dbd8 | ||
|
|
0515afb03a | ||
|
|
0a4623d8e5 | ||
|
|
c6e43ea854 | ||
|
|
62beafe7df | ||
|
|
bd7de99f89 | ||
|
|
17ac380d39 | ||
|
|
8296757a21 | ||
|
|
b12a379e0a | ||
|
|
8ee25f6463 | ||
|
|
ead9e59dc7 | ||
|
|
0eed25cf23 | ||
|
|
6413ea11eb | ||
|
|
b8e348013a | ||
|
|
41a26eab0c | ||
|
|
984bc6ef12 | ||
|
|
9cc83da353 | ||
|
|
a4cc762af8 | ||
|
|
afa572171b | ||
|
|
6efedfc97f | ||
|
|
bf40744f95 | ||
|
|
d4bf1d03ff | ||
|
|
503d37647c | ||
|
|
1ab7d39007 | ||
|
|
30f27e9675 | ||
|
|
fe53834d91 | ||
|
|
8af6ea054a | ||
|
|
b84c999b0a | ||
|
|
aff1abf293 | ||
|
|
5fe9d43ea6 | ||
|
|
d6e46078d1 | ||
|
|
43d747de6d | ||
|
|
82a885131e | ||
|
|
efd4179901 | ||
|
|
1c619d798a | ||
|
|
cecd7d6df3 | ||
|
|
d057475617 | ||
|
|
6310d193a7 | ||
|
|
1b87e62141 | ||
|
|
01bace2a47 | ||
|
|
547fcb6ac3 | ||
|
|
1ce8df827e | ||
|
|
9fecd8e861 | ||
|
|
447fd367d3 | ||
|
|
6235bb0751 | ||
|
|
cd8fa5995c | ||
|
|
750ca5d929 | ||
|
|
849d6ebf1a | ||
|
|
3c413070a3 | ||
|
|
785fe53d2f | ||
|
|
214c3bcaab | ||
|
|
4458baadd0 | ||
|
|
9d413fce93 | ||
|
|
61bf23d8f7 | ||
|
|
296eb6d0ed | ||
|
|
b7458067e7 | ||
|
|
23ee0bf0e5 | ||
|
|
98af94032b | ||
|
|
5fa6763867 | ||
|
|
c6bd7e6d3d | ||
|
|
30fc466581 | ||
|
|
dcb3dafae3 | ||
|
|
059e9a0591 | ||
|
|
2f5e9e4d35 | ||
|
|
732513082d | ||
|
|
7c0792b0ec | ||
|
|
6026a8870e | ||
|
|
0cf05a09c6 | ||
|
|
c91b7181b8 | ||
|
|
7f5e1761c1 | ||
|
|
7992ee6eb9 | ||
|
|
6ccefd9a8f | ||
|
|
2d3e8ffc4e | ||
|
|
04594bdd8f | ||
|
|
012498f419 | ||
|
|
491b3e6444 | ||
|
|
6899d6968d | ||
|
|
d19adfb58f | ||
|
|
28f966364e | ||
|
|
f1317bc1cc | ||
|
|
49ed8b4b22 | ||
|
|
0737853c2e | ||
|
|
948d408f34 | ||
|
|
58e7668bc3 | ||
|
|
387f41df69 | ||
|
|
5c773d1404 | ||
|
|
673ec46524 | ||
|
|
5a5331814a | ||
|
|
5310cf355d | ||
|
|
bca818ee19 | ||
|
|
9ff338c734 | ||
|
|
a618aeae2f | ||
|
|
51b7da62b6 | ||
|
|
8d644a9fbc | ||
|
|
f91ad37e5b | ||
|
|
7aef442b38 | ||
|
|
4672f871b3 | ||
|
|
6f6eb3a71f | ||
|
|
60b710a646 | ||
|
|
cf3d408c60 | ||
|
|
1b8de93d22 | ||
|
|
9ced33939e | ||
|
|
24bcfdc105 | ||
|
|
24382275e8 | ||
|
|
321a199ca7 | ||
|
|
10888fc9b7 | ||
|
|
63967fc542 | ||
|
|
849e00621c | ||
|
|
92a54e5c97 | ||
|
|
1e0f607221 | ||
|
|
a24f7d8fc6 | ||
|
|
05c251cd65 | ||
|
|
2a4d754f0b | ||
|
|
4f40f6a6ea | ||
|
|
d8719adfe1 | ||
|
|
6e35972a97 | ||
|
|
50d43082bb | ||
|
|
aa41fbfeb1 | ||
|
|
37c88bd4e9 | ||
|
|
a0135dda30 | ||
|
|
e3a82f384b | ||
|
|
ee2b502d67 | ||
|
|
e9098b47eb | ||
|
|
8b2da6cb86 | ||
|
|
c33593d6a8 | ||
|
|
c88059fb72 | ||
|
|
6efcb75c11 | ||
|
|
0f7beba769 | ||
|
|
56dfd1993d | ||
|
|
0767a0b598 | ||
|
|
13ad65d0b4 | ||
|
|
f888dc2b20 | ||
|
|
39d2e4e957 | ||
|
|
fc114896a8 | ||
|
|
4e08e13ba5 | ||
|
|
545cb921e0 | ||
|
|
6366fa34c3 | ||
|
|
2f5ca07b5f | ||
|
|
51cd5a1761 | ||
|
|
774942b61f | ||
|
|
f586a2614b | ||
|
|
ef284ea30e | ||
|
|
e106fca107 | ||
|
|
3f7736f6a7 | ||
|
|
69bb9fec77 | ||
|
|
a9b783f5b2 | ||
|
|
77638da47c | ||
|
|
8d5708845b | ||
|
|
c8b9f53065 | ||
|
|
382b8cb25a | ||
|
|
33fe188bf1 | ||
|
|
12fc995a74 | ||
|
|
7b8831770a | ||
|
|
64b93aff32 | ||
|
|
7e731b4220 | ||
|
|
520aa3f59a | ||
|
|
549fac6e86 | ||
|
|
17faea969d | ||
|
|
961c20c2cf | ||
|
|
7d75afdcbc | ||
|
|
c97d7900c3 | ||
|
|
0240abfd02 | ||
|
|
7c620313b3 | ||
|
|
e167d7df02 | ||
|
|
5f5ff0cc3a | ||
|
|
16e65662b9 | ||
|
|
be805d74d5 | ||
|
|
d8d395b568 | ||
|
|
e6b28b422e | ||
|
|
01c62da2f8 | ||
|
|
2325f1d54e | ||
|
|
277e7f14c6 | ||
|
|
3bd5d90447 | ||
|
|
1c501957cf | ||
|
|
fc23baf117 | ||
|
|
e4edeb43e4 | ||
|
|
f42a854b66 | ||
|
|
0c454fad2c | ||
|
|
0f600a99aa | ||
|
|
3a6aa447bd | ||
|
|
42b87a0da6 | ||
|
|
d057e3f620 | ||
|
|
9477b6a022 | ||
|
|
185511162d | ||
|
|
fd716b0ef9 | ||
|
|
b30ebd3f77 | ||
|
|
98f3d2ed0f | ||
|
|
c46952dda6 | ||
|
|
494678aee0 | ||
|
|
bb392aad8d | ||
|
|
0cacacf97d | ||
|
|
c2e5522cb3 | ||
|
|
a8e0dd986b | ||
|
|
dca1a84940 | ||
|
|
21b9f85832 | ||
|
|
73c7552b0c | ||
|
|
44793d1565 | ||
|
|
503a2c7ff6 | ||
|
|
7bcb6ed037 | ||
|
|
2953afcebe | ||
|
|
97becf5c91 | ||
|
|
0aec1a26fa | ||
|
|
5dae3d2c3c | ||
|
|
3ffc4b63a9 | ||
|
|
bf2a2e35a2 | ||
|
|
d3ac2728aa | ||
|
|
4f9db76cf6 | ||
|
|
d047895139 | ||
|
|
d9a1d1bbb3 | ||
|
|
6958ebc2f2 | ||
|
|
10cf2a75b6 | ||
|
|
55166608d5 | ||
|
|
c8f96808d0 | ||
|
|
f38d38c734 | ||
|
|
6e9259f256 | ||
|
|
5d444e8655 | ||
|
|
d2b38730a2 | ||
|
|
b5ea590c55 | ||
|
|
3ac096ff3a | ||
|
|
836c8e692d | ||
|
|
130e234461 | ||
|
|
d717389be9 | ||
|
|
9d88249e98 | ||
|
|
ff48344492 | ||
|
|
5271aebf13 | ||
|
|
9331fc6c62 | ||
|
|
ca06f83c76 | ||
|
|
15fdcbd421 | ||
|
|
04b52cf9e3 | ||
|
|
e0c4a281f0 | ||
|
|
2dd57e2e29 | ||
|
|
3393d2e937 | ||
|
|
a66c01eb26 | ||
|
|
57c0281f11 | ||
|
|
2b08ee79ce | ||
|
|
1237debccc | ||
|
|
56e2010866 | ||
|
|
f7eced68a1 | ||
|
|
9aa849681e | ||
|
|
8c81afab57 | ||
|
|
11fb7a5b43 | ||
|
|
3c64923e1f | ||
|
|
f2b395e31e | ||
|
|
b07ba5c0a3 | ||
|
|
efee5737ac | ||
|
|
5eadfbf34e | ||
|
|
c9db1fb181 | ||
|
|
f59496d2c4 | ||
|
|
cd4e78a87c | ||
|
|
0897443bd6 | ||
|
|
529b8603c3 | ||
|
|
6e7d1bcf15 | ||
|
|
1da4d5940e | ||
|
|
74e1845fc4 | ||
|
|
49f0c56ed7 | ||
|
|
01a631bb22 | ||
|
|
43af58d097 | ||
|
|
383cbada09 | ||
|
|
34c1c1746f | ||
|
|
3056ffc366 | ||
|
|
e2c2d730ca | ||
|
|
f50321245a | ||
|
|
f471140e55 | ||
|
|
b4f7e31d01 | ||
|
|
e4039aec5f | ||
|
|
92667b27ac | ||
|
|
70ec88fbb3 | ||
|
|
c50aea93d6 | ||
|
|
df91b42c4f | ||
|
|
8efc28e3bb | ||
|
|
bbe4e3e118 | ||
|
|
db804e271e | ||
|
|
98430b7bb6 | ||
|
|
b465540faf | ||
|
|
c0bd0d1c57 | ||
|
|
e8c724f2e9 | ||
|
|
feb356edbf | ||
|
|
78a6cc04a5 | ||
|
|
9f2aeb8721 | ||
|
|
e01fc78331 | ||
|
|
ee146dd023 | ||
|
|
86f68c247b | ||
|
|
ca7f8e3e0c | ||
|
|
f3585fe8e6 | ||
|
|
09991874d7 | ||
|
|
e10d2e7b9d | ||
|
|
5ebf518fd3 | ||
|
|
6ef0631ded | ||
|
|
3f0000a176 | ||
|
|
a66bdb67cd | ||
|
|
5fd1bcb8b7 | ||
|
|
529df08b7d | ||
|
|
bfc81c36da | ||
|
|
71109542d8 | ||
|
|
7203111f6d | ||
|
|
278fee3f69 | ||
|
|
87d8e301f9 | ||
|
|
efbd54c387 | ||
|
|
458c0e6f18 | ||
|
|
e43332b063 | ||
|
|
6ea6e4e31b | ||
|
|
58eff344d4 | ||
|
|
f4b1d9bcf1 | ||
|
|
9477e3c8d3 | ||
|
|
46949e386d | ||
|
|
f82388be0b | ||
|
|
bd6fe84b8a | ||
|
|
683638583a | ||
|
|
a48e32392e | ||
|
|
4995f64668 | ||
|
|
52639a0a0f | ||
|
|
33cbccbf01 | ||
|
|
34ed67de1a | ||
|
|
cd3824cb3f | ||
|
|
775fbab6c8 | ||
|
|
5b3238d39c | ||
|
|
7094a6aa9f | ||
|
|
25d8deec0c | ||
|
|
bda3d4380c | ||
|
|
3145ed2f1a | ||
|
|
37f1783e90 | ||
|
|
a04f24abb6 | ||
|
|
8a06201088 | ||
|
|
d56d423876 | ||
|
|
9cd5450613 | ||
|
|
5247a3d3b3 | ||
|
|
79d9df4bb4 | ||
|
|
dfeefeb330 | ||
|
|
d8991dada4 | ||
|
|
988e4f4ce6 | ||
|
|
790ab21225 | ||
|
|
fd6c8946ef | ||
|
|
efe3455021 | ||
|
|
64bdb81cc1 | ||
|
|
68023de6d7 | ||
|
|
9b1ffd7358 | ||
|
|
ece286ed1c | ||
|
|
328a979cdb | ||
|
|
d4ba05cd33 | ||
|
|
1086d94946 | ||
|
|
3daca61885 | ||
|
|
7b0cc9635d | ||
|
|
a46f6035dd | ||
|
|
3996bfd1ab | ||
|
|
3db14b4a3a | ||
|
|
42d0a983a7 | ||
|
|
237cb2794c | ||
|
|
c1e01f7583 | ||
|
|
1385db1f6e | ||
|
|
88264526ed | ||
|
|
eb49b3605a | ||
|
|
fd3723cadc | ||
|
|
a892d3c163 | ||
|
|
afe3a7ff94 | ||
|
|
59d1d8280b | ||
|
|
88b5290e0e | ||
|
|
b5ee9f4093 | ||
|
|
8c3efbacd1 | ||
|
|
50020c0570 | ||
|
|
691176e7a7 | ||
|
|
157c79e09d | ||
|
|
c6450b4916 | ||
|
|
450f95b2d9 | ||
|
|
cfb9073e4a | ||
|
|
31670c3a57 | ||
|
|
3cccc7d844 | ||
|
|
46b4eb01d1 | ||
|
|
2443800e9e | ||
|
|
d381b1b5a6 | ||
|
|
ae4e49b8d9 |
No files matched your search
+4
-3
@@ -15,11 +15,12 @@
|
||||
CODE_OF_CONDUCT.md export-ignore
|
||||
CONTRIBUTING.md export-ignore
|
||||
SECURITY.md export-ignore
|
||||
/docs/Contact.md export-ignore
|
||||
/docs/PRIVACY_POLICY.md export-ignore
|
||||
ACCESSIBILITY.md export-ignore
|
||||
CHANGELOG.md export-ignore
|
||||
changelog/ export-ignore
|
||||
README.md export-ignore
|
||||
/docs/ToS.md export-ignore
|
||||
# The legal documents stay IN the archive: the web build reads all of them
|
||||
# (web/build/legal-versions.ts) and stops when one is missing.
|
||||
|
||||
*.csv export-ignore
|
||||
*.log export-ignore
|
||||
|
||||
@@ -0,0 +1,75 @@
|
||||
name: ♿ Accessibility barrier
|
||||
description: Something on the site or in the apps you can't use, or can only use with trouble - keyboard, screen reader, zoom, contrast, motion
|
||||
title: "[A11y] "
|
||||
labels: ["accessibility"]
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
Thanks for telling me. You don't have to say anything about yourself or why - just what got in the way.
|
||||
Screenshots and recordings are welcome, never required. Rather not post in public? Email **contact@poli0981.dev**.
|
||||
|
||||
Not an accessibility problem? **Bug report** is the form you want.
|
||||
How these reports are handled: [ACCESSIBILITY.md](https://github.com/poli0981/free-steam-games-list/blob/main/ACCESSIBILITY.md).
|
||||
|
||||
- type: dropdown
|
||||
id: surface
|
||||
attributes:
|
||||
label: Where?
|
||||
options:
|
||||
- "Website — https://free-steam-games.win/"
|
||||
- "Desktop app (Windows / macOS / Linux)"
|
||||
- "Android app"
|
||||
- "This repository (README, docs, games/*.md leaderboards)"
|
||||
- "Somewhere else (say below)"
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: input
|
||||
id: page
|
||||
attributes:
|
||||
label: Page or link
|
||||
description: The address, or the page's name in the app (Games, Settings, a game's page...).
|
||||
placeholder: https://free-steam-games.win/games/730
|
||||
|
||||
- type: textarea
|
||||
id: barrier
|
||||
attributes:
|
||||
label: What were you trying to do, and what got in the way?
|
||||
description: Plain words are fine. Steps help if it only happens sometimes.
|
||||
placeholder: |
|
||||
I wanted to open a game from the Games list with the keyboard only.
|
||||
Every row takes two Tab presses, and I lost track of which game I was on.
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: dropdown
|
||||
id: impact
|
||||
attributes:
|
||||
label: How much does it get in the way?
|
||||
options:
|
||||
- "I can't do it at all"
|
||||
- "I can, but it's hard or slow"
|
||||
- "Annoying, but I can live with it"
|
||||
- "Not sure"
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: input
|
||||
id: assistive-tech
|
||||
attributes:
|
||||
label: Assistive technology or settings (optional)
|
||||
description: e.g. NVDA, Narrator, VoiceOver on iOS, TalkBack, keyboard only, 200% zoom, high contrast, reduce motion.
|
||||
|
||||
- type: input
|
||||
id: environment
|
||||
attributes:
|
||||
label: Browser or app version, and OS (optional)
|
||||
description: The app version shows as "Steam · v…" under "F2P Tracker" in the sidebar (in the menu on small screens).
|
||||
placeholder: Firefox on Windows 11 · v2.5.0
|
||||
|
||||
- type: textarea
|
||||
id: extra
|
||||
attributes:
|
||||
label: Anything else? (optional)
|
||||
description: A workaround you found, or a screenshot or recording if you'd like to add one.
|
||||
@@ -0,0 +1,39 @@
|
||||
name: ➕ Add Games
|
||||
description: A free-to-play Steam game that is missing from the list (max 10)
|
||||
title: "[Add Games] "
|
||||
labels: [ "add-game" ]
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
Thanks for the tip! New free games are found on Steam automatically every day,
|
||||
so most turn up on their own within a few days. Use this for one that is still missing.
|
||||
Every game is fetched from Steam and checked (free, a game, reachable) before it is listed.
|
||||
|
||||
- type: textarea
|
||||
id: games
|
||||
attributes:
|
||||
label: Games to add (Steam store links, one per line, max 10)
|
||||
description: A store link or a bare appid. Nothing else is needed, the rest comes from Steam.
|
||||
placeholder: |
|
||||
https://store.steampowered.com/app/730/
|
||||
https://store.steampowered.com/app/570/
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: textarea
|
||||
id: notes
|
||||
attributes:
|
||||
label: Anything worth knowing? (optional)
|
||||
description: e.g. "safe, played 50 h", "kernel anti-cheat", "servers shut down in 2027". Public, like everything here.
|
||||
|
||||
- type: checkboxes
|
||||
id: terms
|
||||
attributes:
|
||||
label: Final check
|
||||
description: Spam/off-topic requests ignored by default. Good luck bro :))
|
||||
options:
|
||||
- label: These games are free to play on Steam right now - not a demo, not DLC, not a paid game
|
||||
required: true
|
||||
- label: I searched the site and they are not listed yet
|
||||
required: true
|
||||
@@ -1,5 +1,5 @@
|
||||
name: 🐛 Bug Report
|
||||
description: Report a bug or wrong data (broken thumbnail, wrong genre, web app issue, etc.)
|
||||
description: Something is broken (web app, desktop or Android app, stale or wrong numbers, broken thumbnail)
|
||||
title: "[Bug] "
|
||||
labels: ["bug"]
|
||||
body:
|
||||
@@ -7,8 +7,10 @@ body:
|
||||
attributes:
|
||||
value: |
|
||||
Thanks for reporting! This broke unemployed dev will check when caffeine kicks in :))
|
||||
For things that aren't bugs (just a missing game / wrong genre), the **Add games** or
|
||||
**Delete game** templates are usually faster.
|
||||
The project is in maintenance mode: a bug gets a fix, a wish does not get a feature.
|
||||
For things that aren't bugs: a missing game uses **Add games**, a wrong genre, type,
|
||||
anti-cheat or note **Edit game**, a game that should go **Delete games**, and something
|
||||
you can't use with a keyboard, a screen reader or zoom has its own **Accessibility barrier** form.
|
||||
|
||||
- type: dropdown
|
||||
id: surface
|
||||
@@ -17,7 +19,10 @@ body:
|
||||
description: Helps me figure out which layer to look at first.
|
||||
options:
|
||||
- "Web app — https://free-steam-games.win/"
|
||||
- "Desktop app (Windows / macOS / Linux)"
|
||||
- "Android app"
|
||||
- "Top online — games/top-online.md"
|
||||
- "Top offline — games/top-offline.md"
|
||||
- "Raw data — data/data_*.jsonl"
|
||||
- "API / direct fetch"
|
||||
- "Other (describe below)"
|
||||
@@ -30,14 +35,12 @@ body:
|
||||
label: What kind of bug?
|
||||
description: Check all that apply (multiple OK).
|
||||
options:
|
||||
- label: Wrong game name / genre / metadata
|
||||
- label: Wrong or stale data from Steam (name, tags, languages, dates)
|
||||
- label: Broken or dead link
|
||||
- label: Thumbnail not showing
|
||||
- label: Reviews / players not updating
|
||||
- label: Wrong game count / total
|
||||
- label: Table / chart layout broken
|
||||
- label: Edit / Add / Delete failed (web app)
|
||||
- label: GPG signature unverified (web app)
|
||||
- label: Service worker / offline cache issue
|
||||
- label: Dropdown / form validation issue
|
||||
- label: Mobile-specific
|
||||
@@ -49,8 +52,8 @@ body:
|
||||
label: Describe the bug
|
||||
description: |
|
||||
What happened? Which game(s) or page(s)? How many records affected?
|
||||
If it's a web-app bug, include the URL after the hash (e.g.
|
||||
`#/games/730` or `#/charts/anti-cheat`).
|
||||
If it's a web-app bug, include the page address (e.g.
|
||||
`https://free-steam-games.win/games/730` or `/charts/anti-cheat`).
|
||||
validations:
|
||||
required: true
|
||||
|
||||
@@ -60,10 +63,10 @@ body:
|
||||
label: Steps to reproduce
|
||||
description: How can I see the bug? Numbered list works great.
|
||||
placeholder: |
|
||||
1. Open #/games
|
||||
1. Open /games
|
||||
2. Filter genre = FPS
|
||||
3. Click row "Counter-Strike 2"
|
||||
4. Edit drawer fails to open
|
||||
3. Click the row "Counter-Strike 2"
|
||||
4. The game page shows no player count
|
||||
|
||||
- type: textarea
|
||||
id: screenshots
|
||||
@@ -71,8 +74,8 @@ body:
|
||||
label: Screenshots / links
|
||||
description: |
|
||||
Paste image URLs (drag-drop into this field works) or links to the
|
||||
affected commit / row / chart. The web app supports per-game
|
||||
permalinks — `https://poli0981.github.io/free-steam-games-list/#/games/{appid}`.
|
||||
affected commit / row / chart. The web app has a page per game —
|
||||
`https://free-steam-games.win/games/{appid}`.
|
||||
|
||||
- type: input
|
||||
id: env-browser
|
||||
@@ -84,9 +87,9 @@ body:
|
||||
- type: input
|
||||
id: env-version
|
||||
attributes:
|
||||
label: Web app version (for web app bugs)
|
||||
description: Hover the F2P Tracker title in the sidebar — it shows the version.
|
||||
placeholder: v0.1
|
||||
label: App version (web, desktop or Android)
|
||||
description: Shown as "Steam · v…" under the F2P Tracker title in the sidebar (in the menu on small screens).
|
||||
placeholder: v2.5.0
|
||||
|
||||
- type: textarea
|
||||
id: console
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
# The repository is in maintenance mode (CONTRIBUTING.md): issues are for the
|
||||
# data, for something broken and for accessibility barriers. Everything else
|
||||
# is sent elsewhere, and blank issues are off so nothing bypasses the forms.
|
||||
blank_issues_enabled: false
|
||||
contact_links:
|
||||
- name: 🔒 Security vulnerability
|
||||
url: https://github.com/poli0981/free-steam-games-list/security/advisories/new
|
||||
about: Report it privately, never as a public issue. See SECURITY.md.
|
||||
- name: 💬 Questions, feedback, chit-chat
|
||||
url: https://github.com/poli0981/free-steam-games-list/discussions
|
||||
about: Discussions. Feature requests are not taken - the project is stable and in maintenance mode.
|
||||
@@ -0,0 +1,60 @@
|
||||
name: ✏️ Edit Game
|
||||
description: A listed game has something wrong (genre, type, anti-cheat, notes, safe)
|
||||
title: "[Edit Game] "
|
||||
labels: [ "edit-game" ]
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
Thanks for the correction! It is recorded as an override, which every pipeline run keeps.
|
||||
Only the human-judged fields can be corrected here. Name, tags, languages, reviews and
|
||||
player counts are whatever Steam says and are refreshed from Steam - if one of those
|
||||
is stale or wrong, use **Bug report** instead.
|
||||
|
||||
- type: input
|
||||
id: game
|
||||
attributes:
|
||||
label: Game (Steam store link or page on the site)
|
||||
placeholder: https://store.steampowered.com/app/730/
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: checkboxes
|
||||
id: fields
|
||||
attributes:
|
||||
label: What is wrong?
|
||||
description: Check all that apply.
|
||||
options:
|
||||
- label: Genre
|
||||
- label: Type (online / offline)
|
||||
- label: Anti-cheat (product, or kernel-level or not)
|
||||
- label: Safe (y / n / ?)
|
||||
- label: Notes
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: textarea
|
||||
id: change
|
||||
attributes:
|
||||
label: What should it say?
|
||||
description: Current value → correct value, per field.
|
||||
placeholder: |
|
||||
genre: Casual → RTS
|
||||
anti_cheat: none → Easy Anti-Cheat (kernel)
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: textarea
|
||||
id: source
|
||||
attributes:
|
||||
label: How do you know? (optional but helpful)
|
||||
description: A link to the store page, the developer's announcement, or "I play it". Public, like everything here.
|
||||
|
||||
- type: checkboxes
|
||||
id: terms
|
||||
attributes:
|
||||
label: Final check
|
||||
description: Spam/off-topic requests ignored by default. Good luck bro :))
|
||||
options:
|
||||
- label: I agree – this is a correction to a game on the list
|
||||
required: true
|
||||
@@ -1,68 +0,0 @@
|
||||
name: 💡 Feature Request / Improvement
|
||||
description: Suggest new feature or improve existing one
|
||||
title: "[Feature] "
|
||||
labels: [ "enhancement" ]
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
Thanks for the idea! This noob dev appreciates it (Grok buddy will help code :)))
|
||||
|
||||
- type: checkboxes
|
||||
id: type
|
||||
attributes:
|
||||
label: Type (choose one only)
|
||||
options:
|
||||
- label: New feature
|
||||
- label: Improvement to existing code/feature
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: input
|
||||
id: title
|
||||
attributes:
|
||||
label: Feature/Improvement name
|
||||
description: Short title (e.g., "Add peak players column")
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: textarea
|
||||
id: reason
|
||||
attributes:
|
||||
label: Why? Reason
|
||||
description: How does it help? (e.g., "Current tables load slow with 200+ games")
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: checkboxes
|
||||
id: priority
|
||||
attributes:
|
||||
label: Priority level (choose one only)
|
||||
options:
|
||||
- label: Not urgent (nice to have)
|
||||
- label: Could be useful
|
||||
- label: Very needed
|
||||
- label: Urgent af
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: textarea
|
||||
id: description
|
||||
attributes:
|
||||
label: How it works? (optional)
|
||||
description: More details or example
|
||||
|
||||
- type: textarea
|
||||
id: code
|
||||
attributes:
|
||||
label: Code snippet/mockup (optional – no malware pls, I'll check though lazy :D)
|
||||
render: python
|
||||
|
||||
- type: checkboxes
|
||||
id: terms
|
||||
attributes:
|
||||
label: Final check
|
||||
description: Off-topic/spam ignored by default. Good luck bro :))
|
||||
options:
|
||||
- label: I agree – this is on-topic
|
||||
required: true
|
||||
@@ -1,37 +0,0 @@
|
||||
name: 📢 Feedback / Rant
|
||||
description: General feedback, complaints, or suggestions not fitting other templates
|
||||
title: "[Feedback] "
|
||||
labels: [ "feedback" ]
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
Spill it bro – good, bad, ugly. This noob dev reads (sometimes :)))
|
||||
|
||||
- type: textarea
|
||||
id: feedback
|
||||
attributes:
|
||||
label: Your feedback
|
||||
description: Docs too strict? Contributing guidelines wrong? Copyright issue? Repo like shit? Something else?
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: checkboxes
|
||||
id: common
|
||||
attributes:
|
||||
label: Common issues? (optional, check all)
|
||||
options:
|
||||
- label: Docs too harsh/complicated
|
||||
- label: Contributing rules wrong
|
||||
- label: Possible copyright/problematic game
|
||||
- label: Repo sucks / needs total overhaul
|
||||
- label: Other (described above)
|
||||
|
||||
- type: checkboxes
|
||||
id: terms
|
||||
attributes:
|
||||
label: Final check
|
||||
description: Off-topic/spam/rude stuff ignored by default. Good luck :))
|
||||
options:
|
||||
- label: I agree – this is real feedback
|
||||
required: true
|
||||
@@ -1,26 +0,0 @@
|
||||
name: ❓ Off-Topic / Other
|
||||
description: Anything not bug/feature/add-game
|
||||
title: "[Other] "
|
||||
labels: ["off-topic"]
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
For random stuff, questions, chit-chat. But if off-topic/spam/violate policy – ignored by default :))
|
||||
|
||||
- type: textarea
|
||||
id: description
|
||||
attributes:
|
||||
label: What is it?
|
||||
description: Go ahead bro
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: checkboxes
|
||||
id: terms
|
||||
attributes:
|
||||
label: Final check
|
||||
description: I understand this might be ignored. Good luck :))
|
||||
options:
|
||||
- label: I agree
|
||||
required: true
|
||||
+20
-9
@@ -34,8 +34,8 @@ updates:
|
||||
patterns: ['@tauri-apps/*']
|
||||
ignore:
|
||||
# Framework majors are migrations with their own staged PRs, not
|
||||
# something to take as an unattended bump. (SvelteKit 3 needs the
|
||||
# cookie override in package.json re-keyed or dropped; see CLAUDE.md.)
|
||||
# something to take as an unattended bump (SvelteKit 3 moved its config,
|
||||
# its $lib alias, its param matchers and the PWA wiring; see CLAUDE.md).
|
||||
- dependency-name: '@sveltejs/kit'
|
||||
update-types: [version-update:semver-major]
|
||||
- dependency-name: '@sveltejs/adapter-static'
|
||||
@@ -44,10 +44,17 @@ updates:
|
||||
update-types: [version-update:semver-major]
|
||||
- dependency-name: tailwindcss
|
||||
update-types: [version-update:semver-major]
|
||||
# `typescript` must stay 6: svelte-check and `svelte-kit sync` need the
|
||||
# JavaScript API that TypeScript 7 does not have. TypeScript 7 is the
|
||||
# `@typescript/native` alias (npm:typescript@~7.0.x), bumped by hand with
|
||||
# it - Dependabot mishandles `npm:` aliases (dependabot-core #16488).
|
||||
# See CLAUDE.md, docs/plan/16-toolchain-2026.md and, for the day 7.1
|
||||
# lets TypeScript 6 go, docs/plan/17-typescript-7.1.md.
|
||||
- dependency-name: typescript
|
||||
update-types: [version-update:semver-major]
|
||||
# The type definitions follow the Node the build runs on (24, in
|
||||
# web-ci.yml and the release workflows), not the newest Node.
|
||||
- dependency-name: '@typescript/native'
|
||||
# The type definitions follow the Node the build runs on (web/.node-version,
|
||||
# which every setup-node repeats), not the newest Node.
|
||||
- dependency-name: '@types/node'
|
||||
update-types: [version-update:semver-major]
|
||||
|
||||
@@ -67,8 +74,10 @@ updates:
|
||||
update-types: [minor, patch]
|
||||
|
||||
# ── Python pipeline ───────────────────────────────────────────────────────
|
||||
# Only does useful work once requirements.txt uses exact `==` pins; with the
|
||||
# current `>=x,<y` ranges Dependabot has nothing to raise.
|
||||
# requirements.txt and requirements-test.txt pin every package, transitive
|
||||
# ones included, with the sha256 of each file; an update must bring the new
|
||||
# hashes too, and CI installs with --require-hashes, so a PR whose hashes
|
||||
# are wrong fails python-tests instead of reaching a data job.
|
||||
- package-ecosystem: pip
|
||||
directory: /
|
||||
schedule:
|
||||
@@ -90,9 +99,11 @@ updates:
|
||||
actions-all:
|
||||
patterns: ['*']
|
||||
ignore:
|
||||
# Action majors are held until the GITHUB_TOKEN checkout migration is
|
||||
# confirmed green — do not stack an untested action-major bump on top
|
||||
# of a credential change you still need to verify.
|
||||
# Majors of these two are taken by hand, for every workflow at once: the
|
||||
# data jobs that check out, commit and push run only on a schedule, so a
|
||||
# pull request's CI never exercises them. Keep ONE major across all
|
||||
# workflows - the Node 20 ones (checkout v4, setup-python v5) printed a
|
||||
# deprecation warning on every run until 2026-10-26.
|
||||
- dependency-name: actions/checkout
|
||||
update-types: [version-update:semver-major]
|
||||
- dependency-name: actions/setup-python
|
||||
|
||||
@@ -0,0 +1,49 @@
|
||||
<!--
|
||||
Thanks for the PR! One person reviews these by hand, so a short "what and why" goes a long way.
|
||||
Everything here is public and permanent: keep personal info (email, real name, account IDs) out of it.
|
||||
Written with an AI assistant? Fine - so was most of this repo. You still checked the boxes yourself.
|
||||
Delete the sections that don't apply.
|
||||
|
||||
The project is stable and in maintenance mode (CONTRIBUTING.md). A pull request is merged when it is:
|
||||
- data: a game added, corrected or removed;
|
||||
- a security fix (report it privately first, SECURITY.md);
|
||||
- a runtime or dependency update, or the repair of what one broke.
|
||||
New features are not taken.
|
||||
-->
|
||||
|
||||
## What and why
|
||||
|
||||
<!-- A sentence or two. "Closes #123" if it fixes an issue. -->
|
||||
|
||||
## Kind of change
|
||||
|
||||
- [ ] Data: add a game (`scripts/temp_info.jsonl`)
|
||||
- [ ] Data: correct a game (`data/overrides/<appid>.json`, written by `scripts/edit_game.py`)
|
||||
- [ ] Data: remove a game (`data/blocklist.jsonl`, written by `scripts/delete_game.py`)
|
||||
- [ ] Security fix
|
||||
- [ ] Runtime / dependency update, or a fix for what one broke
|
||||
- [ ] Docs
|
||||
|
||||
## Checks
|
||||
|
||||
- [ ] Web (`web/`): `npm run typecheck && npm test && npm run build && node scripts/verify-dist.mjs --web`
|
||||
- [ ] Pipeline (`scripts/`): `python -m pytest scripts/tests`
|
||||
- [ ] Overrides or blocklist: `python scripts/edit_game.py --check` / `python scripts/delete_game.py --check`
|
||||
- [ ] Docs or queued links only - nothing to run
|
||||
- [ ] No hand edit to `data/data_*.jsonl` or `data/index.json`
|
||||
|
||||
## Accessibility (only if the interface changed)
|
||||
|
||||
The longer version is in [ACCESSIBILITY.md](https://github.com/poli0981/free-steam-games-list/blob/main/ACCESSIBILITY.md#for-contributors).
|
||||
|
||||
- [ ] Works with the keyboard alone, and focus stays visible
|
||||
- [ ] Controls and icon buttons have a name a screen reader can read; images have `alt` (`alt=""` when decorative)
|
||||
- [ ] Nothing new is shown by colour or a hover tooltip alone, and text stays readable in both themes
|
||||
- [ ] Still usable 360 px wide, at 200% zoom and with reduce motion on
|
||||
- [ ] No new `svelte-ignore a11y_*`, or the description says why
|
||||
- [ ] New text is in both `en.json` and `vi.json`
|
||||
|
||||
## Queued games (`scripts/temp_info.jsonl`)
|
||||
|
||||
- [ ] One store link per line, nothing else
|
||||
- [ ] Free to play on Steam right now - not a demo, not a paid game
|
||||
@@ -80,7 +80,7 @@ jobs:
|
||||
'',
|
||||
'---',
|
||||
'',
|
||||
'*(Auto-posted by `.github/workflows/announce-release-discussion.yml`. Reply with feedback, install issues, or feature requests — full bug reports still go through the [issue templates](../../issues/new/choose).)*',
|
||||
'*(Auto-posted by `.github/workflows/announce-release-discussion.yml`. Reply with feedback or install issues. The project is in maintenance mode, so feature requests are not taken — bug reports and data changes go through the [issue templates](../../issues/new/choose).)*',
|
||||
]
|
||||
.filter(Boolean)
|
||||
.join('\n');
|
||||
|
||||
@@ -3,10 +3,15 @@ name: Backfill Discovery (TEMPORARY)
|
||||
# >>> TEMPORARY. DELETE THIS FILE AND scripts/backfill_discover.py ONCE THE
|
||||
# >>> HISTORICAL BACKLOG HAS BEEN WORKED THROUGH.
|
||||
#
|
||||
# Measured 2026-09-10: Steam lists 16,668 free games matching the catalogue's
|
||||
# own filters; data/ holds 3,424. This workflow chews through that gap one
|
||||
# release window at a time. `Discover New Games` covers everything from today
|
||||
# forward and is permanent -- this one is not.
|
||||
# Measured 2026-09-10: Steam listed 16,668 free games that support English;
|
||||
# data/ held 3,424. This workflow chews through that gap one release window at
|
||||
# a time. `Discover New Games` covers everything from today forward and is
|
||||
# permanent -- this one is not.
|
||||
#
|
||||
# Since v4.6.0 discovery takes games in every language (18,790 free games on
|
||||
# 2026-10-30, 1,592 of them without English), so a window swept before then
|
||||
# needs one more pass. A whole recent year is ~30 search pages; a window is
|
||||
# done only when the log says "walked past the window".
|
||||
#
|
||||
# Same propose-only contract as the daily job: `contents: read`, and the same
|
||||
# guard step asserting no dataset-writing helper is reachable.
|
||||
@@ -29,6 +34,10 @@ on:
|
||||
description: 'Max candidates to propose in one run'
|
||||
required: false
|
||||
default: '250'
|
||||
max_pages:
|
||||
description: 'Search pages to walk once the window is found (100 rows each; a whole recent year is ~30)'
|
||||
required: false
|
||||
default: '40'
|
||||
dry_run:
|
||||
description: 'Find candidates but do not POST them'
|
||||
type: boolean
|
||||
@@ -51,9 +60,12 @@ permissions:
|
||||
concurrency:
|
||||
# Shares the `discovery` group with the daily job on purpose: two sweeps
|
||||
# hammering Steam's search from the same runner pool is the one way to earn a
|
||||
# rate limit that hurts both.
|
||||
# rate limit that hurts both. `queue: max`, like the daily job: windows are
|
||||
# dispatched several at a time, and the default single waiting slot would
|
||||
# cancel all but the last.
|
||||
group: discovery
|
||||
cancel-in-progress: false
|
||||
queue: max
|
||||
|
||||
jobs:
|
||||
backfill:
|
||||
@@ -64,7 +76,7 @@ jobs:
|
||||
|
||||
- uses: actions/setup-python@v6
|
||||
with:
|
||||
python-version: '3.12'
|
||||
python-version: '3.15'
|
||||
|
||||
- name: Assert discovery cannot write the dataset
|
||||
run: |
|
||||
@@ -91,7 +103,8 @@ jobs:
|
||||
exit 1
|
||||
fi
|
||||
|
||||
- run: pip install --quiet -r requirements.txt
|
||||
- run: |
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
|
||||
- name: Backfill
|
||||
env:
|
||||
@@ -101,6 +114,7 @@ jobs:
|
||||
YEAR: ${{ inputs.year }}
|
||||
QUARTER: ${{ inputs.quarter }}
|
||||
LIMIT: ${{ inputs.limit || '250' }}
|
||||
MAX_PAGES: ${{ inputs.max_pages || '40' }}
|
||||
DRY: ${{ inputs.dry_run && '--dry-run' || '' }}
|
||||
run: |
|
||||
# An absent YEAR means this is the scheduled run, so both env defaults
|
||||
@@ -118,7 +132,7 @@ jobs:
|
||||
fi
|
||||
# A blank quarter must be omitted from argv, not passed as an empty
|
||||
# string: argparse rejects '' as an invalid choice.
|
||||
args="--year $YEAR --limit $LIMIT"
|
||||
args="--year $YEAR --limit $LIMIT --max-pages $MAX_PAGES"
|
||||
if [ -n "$QUARTER" ]; then args="$args --quarter $QUARTER"; fi
|
||||
echo "backfill_discover.py $args $DRY"
|
||||
python scripts/backfill_discover.py $args $DRY
|
||||
@@ -1,19 +0,0 @@
|
||||
name : Check Dead Links
|
||||
on :
|
||||
schedule : [ { cron : '0 4 1,6,11,16,21,26 * *' } ]
|
||||
workflow_dispatch :
|
||||
permissions : { contents : write }
|
||||
concurrency :
|
||||
group : data-write
|
||||
cancel-in-progress : false
|
||||
jobs :
|
||||
check :
|
||||
runs-on : ubuntu-latest
|
||||
steps :
|
||||
-
|
||||
uses : actions/checkout@v6
|
||||
-
|
||||
uses : actions/setup-python@v6
|
||||
with : { python-version : '3.12' }
|
||||
-
|
||||
run : chmod +x ./bash/dead_links.sh && ./bash/dead_links.sh
|
||||
@@ -63,8 +63,9 @@ jobs:
|
||||
- uses: actions/checkout@v6
|
||||
- uses: actions/setup-python@v6
|
||||
with:
|
||||
python-version: '3.12'
|
||||
- run: pip install --quiet -r requirements.txt
|
||||
python-version: '3.15'
|
||||
- run: |
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
- name: Validate every override
|
||||
run: python scripts/edit_game.py --check
|
||||
|
||||
@@ -73,20 +74,23 @@ jobs:
|
||||
# a formatting change on either side fails here.
|
||||
- uses: actions/setup-node@v7
|
||||
with:
|
||||
node-version: '24'
|
||||
node-version: '26'
|
||||
cache: 'npm'
|
||||
cache-dependency-path: web/package-lock.json
|
||||
- name: Install web deps
|
||||
working-directory: web
|
||||
run: npm ci
|
||||
# No lifecycle scripts, as in web-ci.yml (which says why that is safe).
|
||||
run: npm ci --ignore-scripts
|
||||
- name: Validate the blocklist
|
||||
# A line load_blocklist() cannot honour blocks nothing - silently.
|
||||
run: python scripts/delete_game.py --check
|
||||
# `npm test -- <file>`, never `npx vitest`: npx may fetch a package that
|
||||
# is not in the lockfile.
|
||||
- name: Assert CLI/Worker override parity
|
||||
working-directory: web
|
||||
run: npx vitest run worker/lib/override-doc.test.ts
|
||||
run: npm test -- worker/lib/override-doc.test.ts
|
||||
- name: Assert CLI/Worker blocklist parity
|
||||
# web-ci only runs for web/**; a Python-only change to the line format
|
||||
# must fail somewhere too.
|
||||
working-directory: web
|
||||
run: npx vitest run shared/removal.test.ts
|
||||
run: npm test -- shared/removal.test.ts
|
||||
@@ -73,13 +73,18 @@ jobs:
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4
|
||||
uses: actions/checkout@v6
|
||||
|
||||
# The one workflow not on the pipeline's Python (3.15, every other
|
||||
# setup-python): CodeQL's supported-languages page lists Python up to
|
||||
# 3.14, and its extractor runs on this interpreter. The pipeline uses no
|
||||
# 3.15-only syntax, so nothing goes unparsed. web/shared/toolchain.test.ts
|
||||
# names this exception; move it when CodeQL lists 3.15.
|
||||
- name: Setup Python
|
||||
if: matrix.language == 'python'
|
||||
uses: actions/setup-python@v6
|
||||
with:
|
||||
python-version: '3.12'
|
||||
python-version: '3.14'
|
||||
|
||||
- name: Initialize CodeQL
|
||||
uses: github/codeql-action/init@v4
|
||||
|
||||
@@ -37,7 +37,7 @@ jobs:
|
||||
name: github-pages
|
||||
url: ${{ steps.deployment.outputs.page_url }}
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/checkout@v6
|
||||
|
||||
- name: Upload redirect page
|
||||
uses: actions/upload-pages-artifact@v5
|
||||
|
||||
@@ -34,11 +34,17 @@ permissions:
|
||||
|
||||
concurrency:
|
||||
# Its own group, NOT `data-write`: this job writes nothing to the repo, so
|
||||
# queueing it behind the ~115-minute data jobs would delay discovery for no
|
||||
# queueing it behind the long data jobs would delay discovery for no
|
||||
# benefit. Two overlapping discovery runs are the only real hazard, and this
|
||||
# covers that.
|
||||
#
|
||||
# `queue: max` keeps every waiting run (up to 100, first in, first out).
|
||||
# Without it the group keeps ONE: a third run - a backfill dispatched while
|
||||
# another waits - cancels the one already waiting. Every member of the group
|
||||
# says the same (Backfill Discovery too); web/shared/pipeline.test.ts holds it.
|
||||
group: discovery
|
||||
cancel-in-progress: false
|
||||
queue: max
|
||||
|
||||
jobs:
|
||||
discover:
|
||||
@@ -49,7 +55,7 @@ jobs:
|
||||
|
||||
- uses: actions/setup-python@v6
|
||||
with:
|
||||
python-version: '3.12'
|
||||
python-version: '3.15'
|
||||
|
||||
# Belt-and-braces for the propose-only guarantee above. `contents: read`
|
||||
# already blocks a push, but this fails the job at the point the intent is
|
||||
@@ -82,7 +88,8 @@ jobs:
|
||||
exit 1
|
||||
fi
|
||||
|
||||
- run: pip install --quiet -r requirements.txt
|
||||
- run: |
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
|
||||
- name: Discover
|
||||
env:
|
||||
|
||||
@@ -5,26 +5,31 @@ on :
|
||||
# fires the ingest on a detached HEAD, and dies with exit 128 on push.
|
||||
#
|
||||
# data/blocklist.jsonl is here too: this job also applies removals
|
||||
# (bash/ingest.sh runs scripts/remove_games.py first). A separate removal
|
||||
# workflow would share `data-write` with this one, and each would evict the
|
||||
# other's pending run.
|
||||
# (bash/ingest.sh runs scripts/remove_games.py first), so one run does both.
|
||||
push : { branches : [ main ], paths : [ 'scripts/temp_info.jsonl', 'data/blocklist.jsonl' ] }
|
||||
# Orphan recovery, not a poll. `data-write` keeps at most ONE run pending and
|
||||
# cancels the older one, so a push here that queues behind a ~115-minute data
|
||||
# job is silently evicted the moment any OTHER data-write workflow queues --
|
||||
# and nothing retries it, leaving approved games sitting in temp_info.jsonl
|
||||
# until the next unrelated push. Re-running on a clear file is free:
|
||||
# ingest_new.py returns immediately and `git diff --staged --quiet` skips the
|
||||
# commit, so this is idempotent by construction.
|
||||
# A safety net, not a poll. Before data-write queued its runs (queue: max),
|
||||
# a push here that waited behind a long data job was evicted the moment any
|
||||
# other data-write workflow queued, and approved games sat in
|
||||
# temp_info.jsonl until the next unrelated push. Nothing is evicted now, but
|
||||
# a failed run still leaves its links queued. Re-running on a clear file is
|
||||
# free: ingest_new.py returns immediately and `git diff --staged --quiet`
|
||||
# skips the commit, so this is idempotent by construction.
|
||||
schedule : [ { cron : '0 */3 * * *' } ]
|
||||
workflow_dispatch :
|
||||
permissions : { contents : write }
|
||||
# queue: max - a run that finds another data job running waits its turn
|
||||
# (first in, first out) instead of evicting the run already waiting.
|
||||
concurrency :
|
||||
group : data-write
|
||||
cancel-in-progress : false
|
||||
queue : max
|
||||
jobs :
|
||||
ingest :
|
||||
runs-on : ubuntu-latest
|
||||
# About seven seconds a game, and an /admin batch holds at most 100. No
|
||||
# time budget: ingest_new.py empties the whole queue file when it is done,
|
||||
# so a game it had not reached would be lost.
|
||||
timeout-minutes : 120
|
||||
steps :
|
||||
-
|
||||
uses : actions/checkout@v6
|
||||
@@ -35,7 +40,7 @@ jobs :
|
||||
with : { ref : main }
|
||||
-
|
||||
uses : actions/setup-python@v6
|
||||
with : { python-version : '3.12' }
|
||||
with : { python-version : '3.15' }
|
||||
-
|
||||
run : chmod +x ./bash/ingest.sh && ./bash/ingest.sh
|
||||
env : { STEAM_API_KEY : '${{ secrets.STEAM_API_KEY }}' }
|
||||
@@ -19,27 +19,32 @@ permissions:
|
||||
contents: write
|
||||
actions: write
|
||||
|
||||
# queue: max - a run that finds another data job running waits its turn
|
||||
# (first in, first out) instead of evicting the run already waiting.
|
||||
concurrency:
|
||||
group: data-write
|
||||
cancel-in-progress: false
|
||||
queue: max
|
||||
|
||||
jobs:
|
||||
mark:
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 20
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/checkout@v6
|
||||
# The tip of main when the job starts, not when it was queued: a run
|
||||
# that waited behind a long data job would otherwise rewrite stale shards.
|
||||
with:
|
||||
ref: main
|
||||
|
||||
- uses: actions/setup-python@v5
|
||||
- uses: actions/setup-python@v6
|
||||
with:
|
||||
python-version: '3.12'
|
||||
python-version: '3.15'
|
||||
cache: 'pip'
|
||||
cache-dependency-path: requirements.txt
|
||||
|
||||
- run: pip install -r requirements.txt
|
||||
- run: |
|
||||
pip install --require-hashes --only-binary :all: -r requirements.txt
|
||||
|
||||
- name: Mark dead games
|
||||
env:
|
||||
|
||||
@@ -13,7 +13,6 @@ on:
|
||||
- "Auto Update JSON Data"
|
||||
- "Top Online Leaderboard"
|
||||
- "Update Reviews"
|
||||
- "Check Dead Links"
|
||||
- "Purge Unhealthy Games"
|
||||
- "Ingest New Game Links"
|
||||
- "Force Re-fetch All (v2.1 Schema)"
|
||||
|
||||
@@ -1,20 +1,45 @@
|
||||
name : Purge Unhealthy Games
|
||||
|
||||
# Takes out the games that left the store, stopped being free or are not out
|
||||
# yet - only when two of Steam's answers agree: IStoreBrowseService/GetItems
|
||||
# screens the whole catalogue in a hundred-odd requests, and appdetails
|
||||
# confirms each game it flags (scripts/purge_unhealthy.py has the rules and
|
||||
# the guards). A few minutes, so it runs daily. It replaces both the old
|
||||
# purge (appdetails for every game, 5.3 hours) and Check Dead Links, a 5.5-hour
|
||||
# HEAD sweep that never found anything: Steam sends a delisted app's page to
|
||||
# the store front, which answers 200.
|
||||
|
||||
on :
|
||||
schedule : [ { cron : '0 5 * * 1' } ]
|
||||
schedule : [ { cron : '0 7 * * *' } ]
|
||||
workflow_dispatch :
|
||||
inputs :
|
||||
dry_run :
|
||||
description : 'Dry run: screen and confirm, remove nothing'
|
||||
type : boolean
|
||||
default : false
|
||||
permissions : { contents : write }
|
||||
# queue: max - a run that finds another data job running waits its turn
|
||||
# (first in, first out) instead of evicting the run already waiting.
|
||||
concurrency :
|
||||
group : data-write
|
||||
cancel-in-progress : false
|
||||
queue : max
|
||||
jobs :
|
||||
purge :
|
||||
runs-on : ubuntu-latest
|
||||
timeout-minutes : 60
|
||||
steps :
|
||||
-
|
||||
uses : actions/checkout@v6
|
||||
# main as it is when the job STARTS: a run that waited its turn must
|
||||
# work on what the job before it committed.
|
||||
with : { ref : main }
|
||||
-
|
||||
uses : actions/setup-python@v6
|
||||
with : { python-version : '3.12' }
|
||||
with : { python-version : '3.15' }
|
||||
-
|
||||
run : chmod +x ./bash/purge.sh && ./bash/purge.sh
|
||||
env : { STEAM_API_KEY : '${{ secrets.STEAM_API_KEY }}' }
|
||||
env :
|
||||
STEAM_API_KEY : '${{ secrets.STEAM_API_KEY }}'
|
||||
JOB_BUDGET_MINUTES : '40'
|
||||
PURGE_DRY_RUN : ${{ inputs.dry_run }}
|
||||
@@ -28,7 +28,16 @@ jobs:
|
||||
- uses: actions/checkout@v6
|
||||
- uses: actions/setup-python@v6
|
||||
with:
|
||||
python-version: '3.12'
|
||||
- run: pip install --quiet -r requirements.txt -r requirements-dev.txt
|
||||
python-version: '3.15'
|
||||
# The data pipeline's own install line, exactly as bash/*.sh run it, so a
|
||||
# Dependabot bump of requirements.txt is proven here before a data job
|
||||
# meets it. Hash mode is all-or-nothing per pip call, hence the second
|
||||
# call for the test tools.
|
||||
- name: Install the pipeline's dependencies
|
||||
run: |
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
- name: Install the test tools
|
||||
run: |
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements-test.txt
|
||||
- name: pytest
|
||||
run: python -m pytest scripts/tests -q
|
||||
@@ -0,0 +1,219 @@
|
||||
# Qodana (JetBrains) static analysis, one linter per Qodana Cloud project:
|
||||
#
|
||||
# typescript - qodana-js web/ https://qodana.cloud/projects/GgGyE
|
||||
# python - qodana-python scripts/ https://qodana.cloud/projects/P2R5k
|
||||
# rust - qodana-rust web/src-tauri/ https://qodana.cloud/projects/40daO
|
||||
#
|
||||
# Each project has its own token (a repository secret) and its own settings
|
||||
# file (the qodana.yaml in the directory above). Every run analyses the whole
|
||||
# project (`pr-mode: false`), so a pull request and `main` report the same way.
|
||||
# All three are Ultimate linters (Qodana for Rust is also Early Access): when
|
||||
# the licence ends, every job fails on it - renew it, or delete this file and
|
||||
# the three qodana.yaml files.
|
||||
#
|
||||
# Dependabot and fork PRs get no repository secrets: the analysis is skipped
|
||||
# there, not failed (the `tokens` job). Dependencies are installed before the
|
||||
# scan, in steps that don't see the token.
|
||||
name: Qodana
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
# Data commits (the pipeline's, the admin Worker's) and docs change no code.
|
||||
paths-ignore:
|
||||
- 'data/**'
|
||||
- 'games/**'
|
||||
- 'scripts/*.jsonl'
|
||||
- 'scripts/*.log'
|
||||
- '**.md'
|
||||
pull_request:
|
||||
paths-ignore:
|
||||
- 'data/**'
|
||||
- 'games/**'
|
||||
- 'scripts/*.jsonl'
|
||||
- 'scripts/*.log'
|
||||
- '**.md'
|
||||
workflow_dispatch:
|
||||
|
||||
permissions: {}
|
||||
|
||||
concurrency:
|
||||
group: qodana-${{ github.ref }}
|
||||
cancel-in-progress: true
|
||||
|
||||
jobs:
|
||||
tokens:
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 5
|
||||
permissions: {}
|
||||
outputs:
|
||||
present: ${{ steps.check.outputs.present }}
|
||||
steps:
|
||||
- name: Check for the Qodana tokens
|
||||
id: check
|
||||
env:
|
||||
HAS_TS_JS: ${{ secrets.QODANA_TOKEN_TS_JS != '' }}
|
||||
HAS_PYTHON: ${{ secrets.QODANA_TOKEN_PYTHON != '' }}
|
||||
HAS_RUST: ${{ secrets.QODANA_TOKEN_RUST != '' }}
|
||||
run: |
|
||||
if [ "$HAS_TS_JS" = true ] && [ "$HAS_PYTHON" = true ] && [ "$HAS_RUST" = true ]; then
|
||||
echo "present=true" >> "$GITHUB_OUTPUT"
|
||||
else
|
||||
echo "::notice::No Qodana tokens in this run (Dependabot or fork PR): Qodana analysis skipped."
|
||||
fi
|
||||
|
||||
typescript:
|
||||
name: TypeScript / JavaScript
|
||||
needs: tokens
|
||||
if: needs.tokens.outputs.present == 'true'
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 40
|
||||
permissions:
|
||||
contents: read
|
||||
checks: write # the action's annotations
|
||||
steps:
|
||||
# The pull request's own head commit, not the merge GitHub makes, so
|
||||
# the report names a commit that exists; full history for its VCS data.
|
||||
- uses: actions/checkout@v6
|
||||
with:
|
||||
ref: ${{ github.event.pull_request.head.sha || github.sha }}
|
||||
fetch-depth: 0
|
||||
persist-credentials: false
|
||||
|
||||
- uses: actions/setup-node@v7
|
||||
with:
|
||||
node-version: '26'
|
||||
cache: 'npm'
|
||||
cache-dependency-path: web/package-lock.json
|
||||
|
||||
# The linter resolves imports and types from node_modules.
|
||||
# --ignore-scripts, as everywhere this repo runs `npm ci` (web-ci.yml
|
||||
# says why).
|
||||
- name: Install web/
|
||||
working-directory: web
|
||||
run: npm ci --ignore-scripts
|
||||
|
||||
# `svelte-kit sync` writes the tsconfig web/tsconfig.json extends and the
|
||||
# route types; the admin build writes worker/generated/, which
|
||||
# worker/index.ts imports. Without them the app reads untyped and the
|
||||
# Worker has an unresolved import (sonarcloud.yml does the same).
|
||||
- name: Generate SvelteKit's types and the admin bundle
|
||||
working-directory: web
|
||||
run: npm run build:admin
|
||||
|
||||
# Docker, not native: the components are .svelte files, which only
|
||||
# JetBrains' Svelte plugin reads (web/qodana.yaml), and installing a
|
||||
# plugin fails in native mode with every released CLI up to 2026.2.3
|
||||
# ("qodana.build.date system property must be set", fixed upstream as
|
||||
# QD-16701 after that release). The container sees this checkout,
|
||||
# node_modules and the generated files included.
|
||||
# --project-dir <subdir> --repository-root . keeps the git data.
|
||||
- name: Qodana scan
|
||||
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
|
||||
with:
|
||||
args: --project-dir web --repository-root . --linter qodana-js
|
||||
pr-mode: false
|
||||
post-pr-comment: false
|
||||
upload-result: true
|
||||
artifact-name: qodana-report-typescript
|
||||
# The default keys are the same for every job of a run.
|
||||
primary-cache-key: qodana-2026.2-js-${{ github.ref }}-${{ github.sha }}
|
||||
additional-cache-key: qodana-2026.2-js-${{ github.ref }}
|
||||
cache-default-branch-only: true
|
||||
env:
|
||||
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_TS_JS }}
|
||||
|
||||
python:
|
||||
name: Python
|
||||
needs: tokens
|
||||
if: needs.tokens.outputs.present == 'true'
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 30
|
||||
permissions:
|
||||
contents: read
|
||||
checks: write
|
||||
steps:
|
||||
- uses: actions/checkout@v6
|
||||
with:
|
||||
ref: ${{ github.event.pull_request.head.sha || github.sha }}
|
||||
fetch-depth: 0
|
||||
persist-credentials: false
|
||||
|
||||
- uses: actions/setup-python@v6
|
||||
with:
|
||||
python-version: '3.15'
|
||||
|
||||
# Hash-locked, wheels only, one pip call per file (hash mode is
|
||||
# all-or-nothing per call), as python-tests.yml. The tests are analysed
|
||||
# too, so pytest has to resolve. In native mode the linter finds no
|
||||
# interpreter by itself (SDKs.json empty: it then calls every
|
||||
# `dict[str, int]` and `X | None` an invalid type hint): it gets this
|
||||
# virtual environment through QODANA_PYTHON_PATH below.
|
||||
- name: Install the pipeline and the test tools
|
||||
run: |
|
||||
python -m venv .venv
|
||||
.venv/bin/pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
.venv/bin/pip install --quiet --require-hashes --only-binary :all: -r requirements-test.txt
|
||||
|
||||
# Native mode (scripts/qodana.yaml): the Qodana image would bring an
|
||||
# older Python. scripts/ is the project: every script and the tests put
|
||||
# it on sys.path and import `core`, which resolves only when scripts/ is
|
||||
# the content root.
|
||||
- name: Qodana scan
|
||||
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
|
||||
with:
|
||||
args: --project-dir scripts --repository-root . --linter qodana-python --within-docker false
|
||||
pr-mode: false
|
||||
post-pr-comment: false
|
||||
upload-result: true
|
||||
artifact-name: qodana-report-python
|
||||
primary-cache-key: qodana-2026.2-python-${{ github.ref }}-${{ github.sha }}
|
||||
additional-cache-key: qodana-2026.2-python-${{ github.ref }}
|
||||
cache-default-branch-only: true
|
||||
env:
|
||||
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_PYTHON }}
|
||||
QODANA_PYTHON_PATH: ${{ github.workspace }}/.venv/bin/python
|
||||
|
||||
rust:
|
||||
name: Rust
|
||||
needs: tokens
|
||||
if: needs.tokens.outputs.present == 'true'
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 45
|
||||
permissions:
|
||||
contents: read
|
||||
checks: write
|
||||
steps:
|
||||
- uses: actions/checkout@v6
|
||||
with:
|
||||
ref: ${{ github.event.pull_request.head.sha || github.sha }}
|
||||
fetch-depth: 0
|
||||
persist-credentials: false
|
||||
|
||||
# tauri::generate_context!() refuses to expand without the frontend
|
||||
# directory (frontendDist, ../dist): an empty page stands in for the
|
||||
# web build, which the analysis does not need.
|
||||
- name: Stand-in for the web build
|
||||
run: |
|
||||
mkdir -p web/dist
|
||||
echo '<!doctype html><title>stand-in</title>' > web/dist/index.html
|
||||
|
||||
# qodana-rust ships only as a Docker image. It runs as root so that its
|
||||
# bootstrap (web/src-tauri/qodana.yaml) can install the C toolchain and
|
||||
# the libraries Tauri links against: without them `cargo check` fails
|
||||
# and the linter loads no Cargo package at all ("Cargo project
|
||||
# loading"). The crates go to the (cached) Qodana cache directory, which
|
||||
# the runner's user could not write in the image's own CARGO_HOME.
|
||||
- name: Qodana scan
|
||||
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
|
||||
with:
|
||||
args: --project-dir web/src-tauri --repository-root . --linter qodana-rust -u root -e CARGO_HOME=/data/cache/cargo
|
||||
pr-mode: false
|
||||
post-pr-comment: false
|
||||
upload-result: true
|
||||
artifact-name: qodana-report-rust
|
||||
primary-cache-key: qodana-2026.2-rust-${{ github.ref }}-${{ github.sha }}
|
||||
additional-cache-key: qodana-2026.2-rust-${{ github.ref }}
|
||||
cache-default-branch-only: true
|
||||
env:
|
||||
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_RUST }}
|
||||
@@ -1,16 +1,25 @@
|
||||
name : Force Re-fetch All (v2.1 Schema)
|
||||
|
||||
# ⚠ MANUAL ONLY – this re-fetches ALL games from Steam.
|
||||
# Takes a long time for large datasets (300+ games ≈ 15-30 min).
|
||||
# Creates a backup at data.jsonl.bak before starting.
|
||||
# ⚠ MANUAL ONLY – this re-fetches games from Steam from scratch, about six
|
||||
# seconds a game: far longer than one job may run once the catalogue is in
|
||||
# the thousands. Run it in PARTS: part "1/8" takes an eighth of the games
|
||||
# (crc32 slices, scripts/refetch_all.py), and the runs for 1/8 ... 8/8 can be
|
||||
# started together - the data-write group queues them (queue: max). A part cut
|
||||
# short by its budget keeps what it did; starting it again carries on with the
|
||||
# games it did not reach. Creates a backup at data.bak before starting.
|
||||
|
||||
on :
|
||||
workflow_dispatch :
|
||||
inputs :
|
||||
confirm :
|
||||
description : 'Type "yes" to confirm force re-fetch of ALL games'
|
||||
description : 'Type "yes" to confirm force re-fetch'
|
||||
required : true
|
||||
type : string
|
||||
part :
|
||||
description : 'Which part, K/N (1/8 ... 8/8 for the whole catalogue)'
|
||||
required : true
|
||||
default : '1/8'
|
||||
type : string
|
||||
|
||||
permissions :
|
||||
contents : write
|
||||
@@ -18,27 +27,34 @@ permissions :
|
||||
concurrency :
|
||||
group : data-write
|
||||
cancel-in-progress : false
|
||||
queue : max
|
||||
|
||||
jobs :
|
||||
refetch :
|
||||
if : ${{ github.event.inputs.confirm == 'yes' }}
|
||||
runs-on : ubuntu-latest
|
||||
timeout-minutes : 120
|
||||
timeout-minutes : 350
|
||||
steps :
|
||||
-
|
||||
name : Checkout repo
|
||||
uses : actions/checkout@v6
|
||||
# main as it is when the job STARTS: a part that waited its turn must
|
||||
# work on what the part before it committed.
|
||||
with :
|
||||
ref : main
|
||||
|
||||
-
|
||||
name : Setup Python
|
||||
uses : actions/setup-python@v6
|
||||
with :
|
||||
python-version : '3.12'
|
||||
python-version : '3.15'
|
||||
|
||||
-
|
||||
name : Force re-fetch all games
|
||||
name : Force re-fetch one part
|
||||
env :
|
||||
STEAM_API_KEY : ${{ secrets.STEAM_API_KEY }}
|
||||
REFETCH_PART : ${{ inputs.part }}
|
||||
JOB_BUDGET_MINUTES : '320'
|
||||
run : |
|
||||
chmod +x ./bash/refetch_all.sh
|
||||
./bash/refetch_all.sh
|
||||
@@ -1,16 +1,18 @@
|
||||
name: Refresh All-Time Peaks
|
||||
|
||||
# all_time_peak - the most players a game has had at once - from SteamCharts'
|
||||
# recorded peak, a thirtieth of the catalogue a day (~186 pages, 2-3 s apart:
|
||||
# about ten minutes), so every game is asked once a month. Every run also
|
||||
# raises the field from our own Steam API samples, which needs no requests.
|
||||
# scripts/refresh_peaks.py has the rules: the field only ever goes up, and a
|
||||
# refusal from SteamCharts ends the run early with a warning, not a failure.
|
||||
# recorded peak, a thirtieth of the catalogue a day (~330 pages, 2-3 s apart:
|
||||
# about a quarter of an hour), so every game is asked once a month. Past 400
|
||||
# pages a day the cycle grows to 60 days and more instead: never more often
|
||||
# than once a month a game. Every run also raises the field from our own
|
||||
# Steam API samples, which needs no requests. scripts/refresh_peaks.py has
|
||||
# the rules: the field only ever goes up, and a refusal from SteamCharts - or
|
||||
# the time budget running out - ends the run early with a warning, not a
|
||||
# failure.
|
||||
#
|
||||
# 19:30 UTC sits between Refresh Store Data (16:00, ~40 minutes) and the Daily
|
||||
# Snapshot (23:00), where only the short Ingest runs are due. Scheduled runs
|
||||
# here start up to a few hours late, and the data-write group keeps only ONE
|
||||
# pending run, so this stays clear of the long morning jobs.
|
||||
# 19:30 UTC sits between Refresh Store Data (16:00, about an hour) and the
|
||||
# Daily Snapshot (23:00). A data job still running only delays this one: the
|
||||
# data-write group queues runs (queue: max) instead of evicting them.
|
||||
#
|
||||
# The one-time backfill is a manual run with the box ticked: every game, about
|
||||
# four hours. Start it in the evening UTC, after Refresh Store Data.
|
||||
@@ -30,15 +32,20 @@ permissions: {contents: write}
|
||||
concurrency:
|
||||
group: data-write
|
||||
cancel-in-progress: false
|
||||
queue: max
|
||||
|
||||
jobs:
|
||||
refresh:
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: ${{ inputs.backfill && 330 || 30 }}
|
||||
timeout-minutes: ${{ inputs.backfill && 340 || 45 }}
|
||||
steps:
|
||||
# main as it is when the job STARTS: a run that waited its turn must
|
||||
# work on what the job before it committed.
|
||||
- uses: actions/checkout@v6
|
||||
with: {ref: main}
|
||||
- uses: actions/setup-python@v6
|
||||
with: {python-version: '3.12'}
|
||||
with: {python-version: '3.15'}
|
||||
- run: chmod +x ./bash/refresh_peaks.sh && ./bash/refresh_peaks.sh
|
||||
env:
|
||||
PEAKS_ALL: ${{ inputs.backfill }}
|
||||
JOB_BUDGET_MINUTES: ${{ inputs.backfill && '300' || '25' }}
|
||||
@@ -5,22 +5,23 @@ name: Refresh Store Data
|
||||
# store page, every game once a week; name, header image, description,
|
||||
# developer/publisher, release date, platforms, Metacritic and DRM notes from
|
||||
# appdetails, every game once a month. Each daily run takes one slice of each
|
||||
# rotation - roughly 630 store pages and 150 appdetails calls, ~40 minutes.
|
||||
# rotation - about 1,400 store pages and 330 appdetails calls at 9,800 games,
|
||||
# an hour. Past 2,000 pages or 500 appdetails a day a cycle doubles instead of
|
||||
# the run growing, so it stays under an hour and a half.
|
||||
# scripts/refresh_store_data.py explains the rotation and the rules (never
|
||||
# blanks a value, never touches MANUAL_FIELDS).
|
||||
#
|
||||
# Then the anti-cheat sweep, committed separately: every game's anti-cheat as
|
||||
# its developer declares it on Steam, about 160 GetItems requests plus a store
|
||||
# its developer declares it on Steam, about 200 GetItems requests plus a store
|
||||
# page for each disclosure Steam does not name there (~70), a few minutes.
|
||||
# scripts/refresh_anticheat.py has its rules: Steam wins, an override wins
|
||||
# over Steam, and no disclosure never clears a value. `only: anticheat` runs
|
||||
# just the sweep.
|
||||
#
|
||||
# 16:00 UTC is the quiet part of this repository's day. Scheduled runs here
|
||||
# start two to five hours late, the morning data jobs (reviews, dead links,
|
||||
# purge) run for two to four hours, and the data-write group keeps only ONE
|
||||
# pending run: a second one queueing behind a running job cancels the first.
|
||||
# Nothing else long is due this late; the Daily Snapshot (23:00) comes after.
|
||||
# 16:00 UTC is the quiet part of this repository's day: scheduled runs here
|
||||
# start up to an hour late, and the morning jobs are done by then. A data job
|
||||
# that is still running only delays this one - the data-write group queues
|
||||
# runs (queue: max) instead of evicting the one waiting.
|
||||
|
||||
on:
|
||||
schedule: [{cron: '0 16 * * *'}]
|
||||
@@ -38,18 +39,22 @@ permissions: {contents: write}
|
||||
concurrency:
|
||||
group: data-write
|
||||
cancel-in-progress: false
|
||||
queue: max
|
||||
|
||||
jobs:
|
||||
refresh:
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 120
|
||||
timeout-minutes: 150
|
||||
steps:
|
||||
# main, not the triggering commit: a run that waited its turn in
|
||||
# data-write must work on the data as it is now, not as it was queued.
|
||||
- uses: actions/checkout@v6
|
||||
with: {ref: main}
|
||||
- uses: actions/setup-python@v6
|
||||
with: {python-version: '3.12'}
|
||||
with: {python-version: '3.15'}
|
||||
- run: chmod +x ./bash/refresh_store.sh && ./bash/refresh_store.sh
|
||||
env:
|
||||
REFRESH_ONLY: ${{ inputs.only }}
|
||||
# The store refresh's budget (core/budget.py); the anti-cheat sweep
|
||||
# after it takes a few minutes and has none.
|
||||
JOB_BUDGET_MINUTES: '100'
|
||||
@@ -37,7 +37,7 @@ jobs:
|
||||
# A manual run builds the tag it is releasing, not whatever main is at by
|
||||
# then: a re-run after a CI-only fix must not ship newer app code under an
|
||||
# older version's tag.
|
||||
- uses: actions/checkout@v5
|
||||
- uses: actions/checkout@v6
|
||||
with:
|
||||
ref: ${{ github.event.inputs.tag || github.ref }}
|
||||
|
||||
@@ -55,16 +55,18 @@ jobs:
|
||||
|
||||
- uses: actions/setup-node@v7
|
||||
with:
|
||||
node-version: '24'
|
||||
node-version: '26'
|
||||
cache: 'npm'
|
||||
cache-dependency-path: web/package-lock.json
|
||||
|
||||
# Third-party actions are pinned to a commit (see release-desktop.yml).
|
||||
- name: Install Rust toolchain + Android targets
|
||||
uses: dtolnay/rust-toolchain@stable
|
||||
uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # v1 (master)
|
||||
with:
|
||||
toolchain: stable
|
||||
targets: aarch64-linux-android,armv7-linux-androideabi,i686-linux-android,x86_64-linux-android
|
||||
|
||||
- uses: Swatinem/rust-cache@v2
|
||||
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
|
||||
with:
|
||||
workspaces: 'web/src-tauri -> target'
|
||||
|
||||
@@ -74,14 +76,14 @@ jobs:
|
||||
# whole release stops before building (android-v2.0.0, 2026-09-17).
|
||||
# Gradle installs the build-tools and platform it needs on its own.
|
||||
- name: Set up Android SDK
|
||||
uses: android-actions/setup-android@v4
|
||||
uses: android-actions/setup-android@be39fa834029ff78f1a44aa3bb0819b8fc2bd8fd # v4.0.4
|
||||
with:
|
||||
packages: platform-tools
|
||||
log-accepted-android-sdk-licenses: false
|
||||
|
||||
- name: Set up Android NDK
|
||||
id: setup-ndk
|
||||
uses: nttld/setup-ndk@v1
|
||||
uses: nttld/setup-ndk@ed92fe6cadad69be94a966a7ee3271275e62f779 # v1.6.0
|
||||
with:
|
||||
ndk-version: r27
|
||||
link-to-sdk: true
|
||||
@@ -93,8 +95,8 @@ jobs:
|
||||
- name: Install web dependencies
|
||||
working-directory: web
|
||||
# Plain `npm ci`, as in web-ci.yml: build from the tested lockfile or
|
||||
# not at all.
|
||||
run: npm ci
|
||||
# not at all, and with no lifecycle scripts (web-ci.yml says why).
|
||||
run: npm ci --ignore-scripts
|
||||
|
||||
- name: Configure release keystore
|
||||
working-directory: web/src-tauri/gen/android
|
||||
@@ -132,7 +134,7 @@ jobs:
|
||||
run: npm run tauri -- android build --apk
|
||||
|
||||
- name: Publish APK to GitHub Release
|
||||
uses: softprops/action-gh-release@v3
|
||||
uses: softprops/action-gh-release@8a0cd651e5b2365bd640854a3fa5dfc70e4875f3 # v3.0.4
|
||||
with:
|
||||
tag_name: ${{ github.event.inputs.tag || github.ref_name }}
|
||||
name: F2P Tracker Android ${{ github.event.inputs.tag || github.ref_name }}
|
||||
|
||||
@@ -11,11 +11,14 @@ on:
|
||||
required: true
|
||||
default: 'desktop-v1.0.0'
|
||||
|
||||
permissions:
|
||||
contents: write
|
||||
# Nothing by default; each job asks for the write it needs (both write to the
|
||||
# release: the build its artefacts, updater-json latest.json).
|
||||
permissions: {}
|
||||
|
||||
jobs:
|
||||
build:
|
||||
permissions:
|
||||
contents: write
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
@@ -28,7 +31,7 @@ jobs:
|
||||
args: ''
|
||||
runs-on: ${{ matrix.platform }}
|
||||
steps:
|
||||
- uses: actions/checkout@v5
|
||||
- uses: actions/checkout@v6
|
||||
|
||||
- name: Install Linux build deps
|
||||
if: matrix.platform == 'ubuntu-latest'
|
||||
@@ -47,28 +50,35 @@ jobs:
|
||||
|
||||
- uses: actions/setup-node@v7
|
||||
with:
|
||||
node-version: '24'
|
||||
node-version: '26'
|
||||
cache: 'npm'
|
||||
cache-dependency-path: web/package-lock.json
|
||||
|
||||
# Third-party actions are pinned to a commit, with the version in a
|
||||
# comment for Dependabot: a moved tag must not reach a job holding the
|
||||
# updater's signing key. rust-toolchain is pinned to a MASTER commit and
|
||||
# given its toolchain explicitly - its `stable` branch is regenerated on
|
||||
# top of master, so a commit of that branch can disappear.
|
||||
- name: Install Rust toolchain
|
||||
uses: dtolnay/rust-toolchain@stable
|
||||
uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # v1 (master)
|
||||
with:
|
||||
toolchain: stable
|
||||
targets: ${{ matrix.platform == 'macos-latest' && 'aarch64-apple-darwin,x86_64-apple-darwin' || '' }}
|
||||
|
||||
- uses: Swatinem/rust-cache@v2
|
||||
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
|
||||
with:
|
||||
workspaces: 'web/src-tauri -> target'
|
||||
|
||||
# Plain `npm ci`, as in web-ci.yml. The `|| npm install` fallback is what
|
||||
# hid a lockfile conflict for a month: a release must build from exactly
|
||||
# the dependencies that were tested, or not at all.
|
||||
# the dependencies that were tested, or not at all. No lifecycle scripts
|
||||
# (web-ci.yml says why none is needed).
|
||||
- name: Install web dependencies
|
||||
working-directory: web
|
||||
run: npm ci
|
||||
run: npm ci --ignore-scripts
|
||||
|
||||
- name: Build Tauri app
|
||||
uses: tauri-apps/tauri-action@v1
|
||||
uses: tauri-apps/tauri-action@1deb371b0cd8bd54025b384f1cd735e725c4060f # v1.0.0
|
||||
env:
|
||||
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||
# Inject the updater minisign private key so artefacts are signed
|
||||
@@ -99,5 +109,42 @@ jobs:
|
||||
Compiled from commit `${{ github.sha }}`.
|
||||
releaseDraft: true
|
||||
prerelease: false
|
||||
includeUpdaterJson: true
|
||||
uploadUpdaterJson: true
|
||||
args: ${{ matrix.args }}
|
||||
|
||||
# tauri-action v1 writes each artefact's API URL into latest.json
|
||||
# (api.github.com/repos/<repo>/releases/assets/<id>), and has no setting to
|
||||
# change that. /api/updates/desktop (worker/routes/updates.ts) accepts only
|
||||
# this release's download URLs and answers 204 - "no update" - to anything
|
||||
# else, so desktop-v2.2.1, the first release built with v1, was offered to
|
||||
# no installed app until its latest.json was fixed by hand. Once every
|
||||
# platform has added its entries, scripts/updater_json.py rewrites them; it
|
||||
# refuses an entry whose signature is not its file's .sig.
|
||||
updater-json:
|
||||
needs: build
|
||||
permissions:
|
||||
contents: write
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v6
|
||||
|
||||
# updater_json.py is stdlib-only, but it runs on the pipeline's Python
|
||||
# like every other script, not on whatever the runner image ships.
|
||||
- uses: actions/setup-python@v6
|
||||
with:
|
||||
python-version: '3.15'
|
||||
|
||||
- name: Point latest.json at the release downloads
|
||||
env:
|
||||
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||
TAG: ${{ github.event.inputs.tag || github.ref_name }}
|
||||
run: |
|
||||
set -euo pipefail
|
||||
work="$RUNNER_TEMP/updater-json"
|
||||
mkdir -p "$work"
|
||||
gh release download "$TAG" --repo "$GITHUB_REPOSITORY" --dir "$work" \
|
||||
--pattern latest.json --pattern '*.sig'
|
||||
gh release view "$TAG" --repo "$GITHUB_REPOSITORY" --json assets \
|
||||
--jq '[.assets[] | {id: (.apiUrl | split("/") | last), name}]' > "$work/assets.json"
|
||||
(cd "$work" && python3 "$GITHUB_WORKSPACE/scripts/updater_json.py" "$TAG")
|
||||
gh release upload "$TAG" "$work/latest.json" --repo "$GITHUB_REPOSITORY" --clobber
|
||||
@@ -4,15 +4,22 @@ on:
|
||||
workflow_dispatch:
|
||||
permissions: {contents: write}
|
||||
# Shares the data-write group with every other workflow that commits to
|
||||
# data/ — without it this can push mid-run against a 2-hour job.
|
||||
# data/ — without it this can push mid-run against a long job. queue: max -
|
||||
# a run that finds another data job running waits its turn (first in, first
|
||||
# out) instead of evicting the run already waiting.
|
||||
concurrency:
|
||||
group: data-write
|
||||
cancel-in-progress: false
|
||||
queue: max
|
||||
jobs:
|
||||
snapshot:
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 20
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/setup-python@v5
|
||||
with: {python-version: '3.12'}
|
||||
# main as it is when the job STARTS, so the snapshot holds what the
|
||||
# jobs before it committed.
|
||||
- uses: actions/checkout@v6
|
||||
with: {ref: main}
|
||||
- uses: actions/setup-python@v6
|
||||
with: {python-version: '3.15'}
|
||||
- run: chmod +x ./bash/snapshot.sh && ./bash/snapshot.sh
|
||||
@@ -0,0 +1,106 @@
|
||||
name: SonarCloud
|
||||
|
||||
# CI-based analysis, which replaced SonarCloud's automatic analysis: the two
|
||||
# cannot both be on, and the scan fails while automatic analysis is enabled in
|
||||
# the project's Administration > Analysis Method. What is code, what is test
|
||||
# and what is not analysed at all is sonar-project.properties at the root.
|
||||
# SonarCloud's GitHub App still posts the "SonarCloud Code Analysis" check on
|
||||
# the pull request; this job runs both test suites for their coverage and
|
||||
# uploads the analysis.
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
# What the data jobs commit, all of it outside the analysis scope: a
|
||||
# commit that touches nothing else has nothing new to analyse.
|
||||
paths-ignore: ['data/**', 'games/**', 'scripts/*.jsonl', 'scripts/*.log']
|
||||
pull_request:
|
||||
types: [opened, synchronize, reopened]
|
||||
paths-ignore: ['data/**', 'games/**', 'scripts/*.jsonl', 'scripts/*.log']
|
||||
workflow_dispatch:
|
||||
|
||||
permissions: {}
|
||||
|
||||
concurrency:
|
||||
# SonarCloud refuses an analysis older than the last one it has for a
|
||||
# branch, so main's runs queue rather than overlap.
|
||||
group: sonarcloud-${{ github.ref }}
|
||||
cancel-in-progress: ${{ github.event_name == 'pull_request' }}
|
||||
|
||||
jobs:
|
||||
# Pull requests from forks and from Dependabot get no repository secrets.
|
||||
# Without the token the scan cannot upload anything, so the scan job is
|
||||
# skipped rather than failing every such pull request.
|
||||
token:
|
||||
runs-on: ubuntu-latest
|
||||
outputs:
|
||||
present: ${{ steps.check.outputs.present }}
|
||||
steps:
|
||||
- name: Check for the token
|
||||
id: check
|
||||
env:
|
||||
HAS_TOKEN: ${{ secrets.SONAR_TOKEN != '' }}
|
||||
run: |
|
||||
echo "present=$HAS_TOKEN" >> "$GITHUB_OUTPUT"
|
||||
if [ "$HAS_TOKEN" != "true" ]; then
|
||||
echo "::notice::SONAR_TOKEN is not available to this run; skipping the SonarCloud scan."
|
||||
fi
|
||||
|
||||
scan:
|
||||
needs: token
|
||||
if: needs.token.outputs.present == 'true'
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 20
|
||||
permissions:
|
||||
contents: read
|
||||
steps:
|
||||
# Full history: SonarCloud blames every line to tell new code from old.
|
||||
- uses: actions/checkout@v6
|
||||
with:
|
||||
fetch-depth: 0
|
||||
persist-credentials: false
|
||||
|
||||
# Python coverage: coverage.xml at the root (pyproject.toml's
|
||||
# [tool.coverage.run] says what is measured). The pipeline's install line
|
||||
# and then the test tools, each in its own pip call, as python-tests.yml.
|
||||
- uses: actions/setup-python@v6
|
||||
with:
|
||||
python-version: '3.15'
|
||||
|
||||
- name: Install the pipeline and the test tools
|
||||
run: |
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements-test.txt
|
||||
|
||||
- name: pytest with coverage
|
||||
run: python -m pytest scripts/tests -q --cov --cov-report=xml
|
||||
|
||||
# TypeScript coverage: web/coverage/lcov.info (vite.config.ts's
|
||||
# test.coverage). build:admin runs `svelte-kit sync` - web/tsconfig.json
|
||||
# extends the tsconfig it generates, and without it the analyser logs
|
||||
# "Failed to parse tsconfig" and reads web/src with no types - and writes
|
||||
# the admin bundle worker/index.ts imports, which the Worker's tests load.
|
||||
# node_modules, .svelte-kit and the bundle are gitignored, so none of
|
||||
# them is analysed itself.
|
||||
- uses: actions/setup-node@v7
|
||||
with:
|
||||
node-version: '26'
|
||||
cache: 'npm'
|
||||
cache-dependency-path: web/package-lock.json
|
||||
|
||||
# --ignore-scripts, as everywhere this repo runs `npm ci` (web-ci.yml
|
||||
# says why).
|
||||
- name: Install web/
|
||||
working-directory: web
|
||||
run: npm ci --ignore-scripts
|
||||
|
||||
- name: vitest with coverage
|
||||
working-directory: web
|
||||
run: |
|
||||
npm run build:admin
|
||||
npm run test:coverage
|
||||
|
||||
- name: SonarCloud scan
|
||||
uses: SonarSource/sonarqube-scan-action@59202af334b4ba7b5db01b701b8e79f8b3bef0f4 # v8.5.0
|
||||
env:
|
||||
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
|
||||
@@ -5,15 +5,27 @@ on:
|
||||
schedule: [{cron: '0 5 1,15 * *'}]
|
||||
workflow_dispatch:
|
||||
permissions: {contents: write}
|
||||
# queue: max - a run that finds another data job running waits its turn
|
||||
# (first in, first out) instead of evicting the run already waiting.
|
||||
concurrency:
|
||||
group: data-write
|
||||
cancel-in-progress: false
|
||||
queue: max
|
||||
jobs:
|
||||
leaderboard:
|
||||
runs-on: ubuntu-latest
|
||||
# About 0.55 s a game through the keyed Web API: ~65 minutes for 7,000
|
||||
# offline games, ~2 hours at 14,000. The budget stops the sampling with
|
||||
# time left to save and commit.
|
||||
timeout-minutes: 240
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/setup-python@v5
|
||||
with: {python-version: '3.12'}
|
||||
# main as it is when the job STARTS: a run that waited its turn must
|
||||
# work on what the job before it committed.
|
||||
- uses: actions/checkout@v6
|
||||
with: {ref: main}
|
||||
- uses: actions/setup-python@v6
|
||||
with: {python-version: '3.15'}
|
||||
- run: chmod +x ./bash/offline.sh && ./bash/offline.sh
|
||||
env: {STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'}
|
||||
env:
|
||||
STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'
|
||||
JOB_BUDGET_MINUTES: '200'
|
||||
@@ -3,15 +3,27 @@ on:
|
||||
schedule: [{cron: '0 3 * * 0,3,5'}]
|
||||
workflow_dispatch:
|
||||
permissions: {contents: write}
|
||||
# queue: max - a run that finds another data job running waits its turn
|
||||
# (first in, first out) instead of evicting the run already waiting.
|
||||
concurrency:
|
||||
group: data-write
|
||||
cancel-in-progress: false
|
||||
queue: max
|
||||
jobs:
|
||||
leaderboard:
|
||||
runs-on: ubuntu-latest
|
||||
# The player counts come from the keyed Web API with no pause between
|
||||
# batches, about 0.55 s a game: ~27 minutes for 2,900 online games. The
|
||||
# budget stops the sampling with time left to save and commit.
|
||||
timeout-minutes: 150
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/setup-python@v5
|
||||
with: {python-version: '3.12'}
|
||||
# main as it is when the job STARTS: a run that waited its turn must
|
||||
# work on what the job before it committed.
|
||||
- uses: actions/checkout@v6
|
||||
with: {ref: main}
|
||||
- uses: actions/setup-python@v6
|
||||
with: {python-version: '3.15'}
|
||||
- run: chmod +x ./bash/online.sh && ./bash/online.sh
|
||||
env: {STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'}
|
||||
env:
|
||||
STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'
|
||||
JOB_BUDGET_MINUTES: '120'
|
||||
@@ -3,15 +3,26 @@ on:
|
||||
schedule: [{cron: '0 0 * * *'}]
|
||||
workflow_dispatch:
|
||||
permissions: {contents: write}
|
||||
# queue: max - a run that finds another data job running waits its turn
|
||||
# (first in, first out) instead of evicting the run already waiting.
|
||||
concurrency:
|
||||
group: data-write
|
||||
cancel-in-progress: false
|
||||
queue: max
|
||||
jobs:
|
||||
update:
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 90
|
||||
steps:
|
||||
# main as it is when the job STARTS. The commit the scheduled run was
|
||||
# created on is older whenever another data job ran first, and this one
|
||||
# then failed on a conflict in data/index.json (four times in ten days,
|
||||
# October 2026).
|
||||
- uses: actions/checkout@v6
|
||||
with: {ref: main}
|
||||
- uses: actions/setup-python@v6
|
||||
with: {python-version: '3.12'}
|
||||
with: {python-version: '3.15'}
|
||||
- run: chmod +x ./bash/json.sh && ./bash/json.sh
|
||||
env: {STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'}
|
||||
env:
|
||||
STEAM_API_KEY: '${{ secrets.STEAM_API_KEY }}'
|
||||
JOB_BUDGET_MINUTES: '60'
|
||||
@@ -1,19 +1,40 @@
|
||||
name : Update Reviews
|
||||
|
||||
# Every game's review summary from IStoreBrowseService/GetItems, fifty games a
|
||||
# request: about two minutes for the whole catalogue (scripts/update_reviews.py
|
||||
# has the rules). It used to ask appreviews about one game at a time and, at
|
||||
# 9,800 games, ran into GitHub's six-hour limit with nothing saved.
|
||||
|
||||
on :
|
||||
schedule : [ { cron : '0 6 */2 * *' } ]
|
||||
schedule : [ { cron : '0 6 * * *' } ]
|
||||
workflow_dispatch :
|
||||
inputs :
|
||||
dry_run :
|
||||
description : 'Dry run: read Steam, write nothing'
|
||||
type : boolean
|
||||
default : false
|
||||
permissions : { contents : write }
|
||||
# queue: max - a run that finds another data job running waits its turn
|
||||
# (first in, first out) instead of evicting the run already waiting.
|
||||
concurrency :
|
||||
group : data-write
|
||||
cancel-in-progress : false
|
||||
queue : max
|
||||
jobs :
|
||||
reviews :
|
||||
runs-on : ubuntu-latest
|
||||
timeout-minutes : 60
|
||||
steps :
|
||||
-
|
||||
uses : actions/checkout@v6
|
||||
# main as it is when the job STARTS: a run that waited its turn must
|
||||
# work on what the job before it committed.
|
||||
with : { ref : main }
|
||||
-
|
||||
uses : actions/setup-python@v6
|
||||
with : { python-version : '3.12' }
|
||||
with : { python-version : '3.15' }
|
||||
-
|
||||
run : chmod +x ./bash/reviews.sh && ./bash/reviews.sh
|
||||
env :
|
||||
JOB_BUDGET_MINUTES : '40'
|
||||
REVIEWS_DRY_RUN : ${{ inputs.dry_run }}
|
||||
@@ -5,12 +5,16 @@ name: Web CI
|
||||
# during the Cloudflare migration, nothing would validate the frontend at all.
|
||||
# Cloudflare Workers Builds deploys the site; this workflow only *checks* it.
|
||||
|
||||
# Workflow and Sonar changes run it too: web/shared/pipeline.test.ts and
|
||||
# web/shared/toolchain.test.ts read .github/workflows/ (the data-write group, the
|
||||
# Node and Python pins) and sonar-project.properties, and a pull request that
|
||||
# touches only those files is exactly the one that can break them.
|
||||
on:
|
||||
pull_request:
|
||||
paths: ['web/**', '.github/workflows/web-ci.yml']
|
||||
paths: ['web/**', '.github/workflows/**', 'sonar-project.properties']
|
||||
push:
|
||||
branches: [main]
|
||||
paths: ['web/**', '.github/workflows/web-ci.yml']
|
||||
paths: ['web/**', '.github/workflows/**', 'sonar-project.properties']
|
||||
workflow_dispatch:
|
||||
|
||||
permissions:
|
||||
@@ -27,11 +31,11 @@ jobs:
|
||||
run:
|
||||
working-directory: web
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/checkout@v6
|
||||
|
||||
- uses: actions/setup-node@v7
|
||||
with:
|
||||
node-version: '24'
|
||||
node-version: '26'
|
||||
cache: 'npm'
|
||||
cache-dependency-path: web/package-lock.json
|
||||
|
||||
@@ -40,8 +44,16 @@ jobs:
|
||||
# was tried, and the step still went red only at the very end — while
|
||||
# locally everyone kept a stale node_modules. A lockfile that cannot be
|
||||
# installed cleanly is a failure, not something to work around.
|
||||
#
|
||||
# --ignore-scripts everywhere this repo runs `npm ci`: a dependency's
|
||||
# install script would otherwise run with this job's token (and, in the
|
||||
# release workflows, the signing keys). Three packages have one, and none
|
||||
# is needed: esbuild (wrangler's) and workerd only hard-link the binary
|
||||
# from their @esbuild/* and @cloudflare/workerd-* optional packages, which
|
||||
# they also find without it, and fsevents is macOS file watching, which
|
||||
# no build uses. The root package.json has no lifecycle scripts.
|
||||
- name: Install
|
||||
run: npm ci
|
||||
run: npm ci --ignore-scripts
|
||||
|
||||
# Covers BOTH tsconfigs. tsconfig.json only includes ["src",
|
||||
# "vite.config.ts"], so before tsconfig.worker.json existed the Worker
|
||||
@@ -67,9 +79,10 @@ jobs:
|
||||
|
||||
# Bundles the Worker and resolves every binding in wrangler.jsonc without
|
||||
# deploying or needing credentials. Catches a broken config here rather
|
||||
# than in the Cloudflare dashboard after a push.
|
||||
# than in the Cloudflare dashboard after a push. Through the npm script,
|
||||
# not `npx`, which may fetch a package that is not in the lockfile.
|
||||
- name: Worker build check
|
||||
run: npx wrangler deploy --dry-run
|
||||
run: npm run cf:check
|
||||
|
||||
# knip.json is warn-only, so this reports dead code without failing the
|
||||
# build. Flip the rules in knip.json to error when the backlog is clear.
|
||||
@@ -87,16 +100,16 @@ jobs:
|
||||
run:
|
||||
working-directory: web
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/checkout@v6
|
||||
|
||||
- uses: actions/setup-node@v7
|
||||
with:
|
||||
node-version: '24'
|
||||
node-version: '26'
|
||||
cache: 'npm'
|
||||
cache-dependency-path: web/package-lock.json
|
||||
|
||||
- name: Install
|
||||
run: npm ci
|
||||
run: npm ci --ignore-scripts
|
||||
|
||||
- name: Build (Tauri configuration)
|
||||
env:
|
||||
|
||||
+1
-2
@@ -13,8 +13,6 @@ Thumbs.db
|
||||
# scripts/mark_dead_games.py and explicitly staged by mark-dead-games.yml.
|
||||
# It survives *.log today only because ignore rules do not apply to
|
||||
# already-tracked files -- rename or recreate it and it silently vanishes.
|
||||
# (scripts/dead_links.log is deliberately NOT excepted: bash/dead_links.sh
|
||||
# runs `git add .`, and that log is local diagnostic output.)
|
||||
!scripts/dead_games.log
|
||||
*.tmp
|
||||
*.temp
|
||||
@@ -120,6 +118,7 @@ pip-delete-this-directory.txt
|
||||
.coverage.*
|
||||
htmlcov/
|
||||
*.cover
|
||||
coverage.xml
|
||||
|
||||
# Jupyter Notebook
|
||||
.ipynb_checkpoints
|
||||
|
||||
@@ -0,0 +1,242 @@
|
||||
# Accessibility
|
||||
|
||||
This file is about using this project with a keyboard, a screen reader, zoom,
|
||||
high contrast or reduced motion, or with anything else that is not a mouse and
|
||||
a default screen. It covers:
|
||||
|
||||
- the website, <https://free-steam-games.win/>;
|
||||
- the desktop and Android apps, which are the same interface running in the
|
||||
system's web view;
|
||||
- the data as plain text: [`data/`](data/) (JSONL), the CSV/JSON export on the
|
||||
Games page, and the Markdown leaderboards in [`games/`](games/).
|
||||
|
||||
It does not cover Steam's own pages, Cloudflare's Turnstile widget (the
|
||||
website's human check) or GitHub itself. Those belong to Valve, Cloudflare and
|
||||
GitHub.
|
||||
|
||||
One person maintains this as a hobby, and nobody has audited it. So this is not
|
||||
a certificate. It is a list of what is known to work, what is known not to, and
|
||||
how to say so when something gets in your way.
|
||||
|
||||
## The goal
|
||||
|
||||
**[WCAG 2.2](https://www.w3.org/TR/WCAG22/) Level AA** is the target. It is a
|
||||
target, not a claim: the app has not been audited against it, and the
|
||||
limitations below mean it does not meet it today.
|
||||
|
||||
What matters most, in this order:
|
||||
|
||||
1. Finding and opening a game (search, filters, the games list, a game's page)
|
||||
with a keyboard, a screen reader or zoom.
|
||||
2. Nothing said with colour alone, or only in a mouse-hover tooltip.
|
||||
3. No traps, including the first-run screens every visitor has to get past.
|
||||
4. The reader's own settings win: language, reduced motion, light or dark,
|
||||
zoom.
|
||||
|
||||
## What works today
|
||||
|
||||
Checked against the code on 2026-11-09, for the website and the desktop and
|
||||
Android apps 2.5.1.
|
||||
|
||||
- **Language.** The page declares its language, and changes it when you
|
||||
switch between English and Vietnamese.
|
||||
- **Structure.** "Skip to content" is the first thing the keyboard reaches.
|
||||
The header and both navigation menus are labelled, and the menus mark the
|
||||
page you are on. Each page has one main heading and its own title, and
|
||||
moving to another page announces the new title.
|
||||
- **Keyboard.** Links and controls show a focus ring.
|
||||
<kbd>Ctrl</kbd>/<kbd>⌘</kbd>+<kbd>K</kbd> opens a command palette that
|
||||
works like a search box with a list: arrow keys, <kbd>Enter</kbd>,
|
||||
<kbd>Esc</kbd>. The menu drawer on small screens, the palette and the
|
||||
desktop update dialog keep focus inside while they are open, close with
|
||||
<kbd>Esc</kbd>, and put focus back where it was.
|
||||
- **The games table.** A screen reader hears a table: column headers
|
||||
(including names for the image, data-issue and Steam columns), the total
|
||||
number of rows and columns, and the position of each row, even though only
|
||||
the rows on screen exist. Each row is one stop for <kbd>Tab</kbd>, the
|
||||
game's name, and the whole row lights up when it has focus. Clicking
|
||||
anywhere on a row still opens the game. On a phone the cards are a list
|
||||
that says how many games it holds and where you are in it.
|
||||
- **The first-run screens.** The terms screen and the human check are
|
||||
dialogs. Focus moves into them, and the page behind is out of reach for the
|
||||
keyboard and for screen readers until you are through. The command palette
|
||||
shortcut does nothing while they are open.
|
||||
- **Names.** Buttons that only show an icon have a text name. Switches (the
|
||||
language and theme buttons, the scrollbar options, the choices on *Random
|
||||
games*, the anti-cheat families) say whether they are on.
|
||||
- **Colour and contrast.** In both themes, text is at least 4.5:1 against its
|
||||
background, badges and the current menu item included, and the edges of
|
||||
text boxes and drop-downs are at least 3:1. Kernel-level anti-cheat carries
|
||||
a shield icon as well as its red, and the words "Kernel-level". They are
|
||||
spelled out on a game's page and read out by screen readers in the table,
|
||||
the cards and *Random games*. A test computes these ratios from the theme's
|
||||
colours, so a later colour change cannot quietly undo them.
|
||||
- **Charts.** Each chart is announced as an image named by its title. Some
|
||||
also give the numbers as text: *Top online* and *Top offline* list 100 games
|
||||
under their charts, *Genres* lists the top 24, *Tags* writes out 40 of its
|
||||
60 words with their counts, and the anti-cheat chart links to a real table
|
||||
that also says, in words, which anti-cheat runs at kernel level.
|
||||
- **Images, sound and motion.** Game art is decorative (`alt=""`); the game's
|
||||
name is always written next to it. Nothing plays sound or video. With your
|
||||
system's *reduce motion* setting on, page animations and transitions are cut
|
||||
short, and scrolling jumps instead of gliding, "back to top" included.
|
||||
- **Zoom and small screens.** The website never blocks pinch-zoom, and the
|
||||
games list keeps a usable height at 400% zoom. The desktop app zooms with
|
||||
<kbd>Ctrl</kbd>/<kbd>⌘</kbd> and <kbd>+</kbd> / <kbd>−</kbd>. Below tablet
|
||||
width the games table turns into cards, and a test checks that every grid
|
||||
falls back to one column on a phone.
|
||||
- **Settings.** Theme (dark by default, light, or follow the system), English
|
||||
or Vietnamese, and hidden scrollbars. Hidden scrollbars still scroll from
|
||||
the keyboard.
|
||||
- **Plain text.** Every game has its own page. The Games page exports what you
|
||||
have filtered as CSV or JSON. The whole dataset is plain JSONL in
|
||||
[`data/`](data/), and the two leaderboards are Markdown tables in
|
||||
[`games/`](games/).
|
||||
|
||||
## Known limitations
|
||||
|
||||
Known, and not fixed yet. Where there is another way to get the same thing, it
|
||||
says so.
|
||||
|
||||
- **Charts.** Values, tooltips and legends are drawn on a canvas and need a
|
||||
pointer. Several charts have no text version: DRM, languages, platforms,
|
||||
players, reviews, release years, delisted games, most of *Stats*, and the
|
||||
genre chart on the dashboard. Several tell categories apart by colour alone.
|
||||
Chart animations ignore *reduce motion*.
|
||||
*Instead:* the CSV/JSON export, or the raw data.
|
||||
- **The games table is virtualised.** Only the rows on screen exist in the
|
||||
page. A screen reader is told the full count, but the browser's
|
||||
find-in-page only sees those rows.
|
||||
*Instead:* narrow the list with search and the filters, or export to
|
||||
CSV/JSON.
|
||||
- **The human check is Cloudflare Turnstile,** in a frame this project does
|
||||
not control. If it says your browser is unsupported, there is no retry
|
||||
button.
|
||||
*Instead:* the desktop and Android apps never show it, and everything in
|
||||
the catalogue is readable on GitHub.
|
||||
- **Hover-only hints.** To sighted readers, the 💀 on a dead game and the
|
||||
warning icon in a table row explain themselves only in a mouse-hover
|
||||
tooltip. Screen readers get the words.
|
||||
*Instead:* **Hide dead** on the Games page takes dead games out of the
|
||||
list.
|
||||
- **Changes that are not announced:** the number of results after you filter,
|
||||
the page number, and loading or error messages. The pop-up notifications'
|
||||
own labels ("Notifications", "Close toast") stay in English when the app is
|
||||
in Vietnamese.
|
||||
- **Text in another language is not marked as such.** The legal documents
|
||||
exist only in English. Game names and descriptions are in whatever language
|
||||
the developer wrote them. None of it is tagged, so a screen reader reads it
|
||||
in the interface language's voice.
|
||||
- **Contrast themes** (Windows' forced colours) get no special support.
|
||||
- **Zoom.** Long values are cut off with "…", and a few small labels have
|
||||
fixed pixel sizes. As far as the code shows, the Android app does not
|
||||
pinch-zoom.
|
||||
*Instead:* game pages and the CSV/JSON export, the website in a browser, or
|
||||
your system's magnifier or text size.
|
||||
- **Automated checks are static.** A test holds the fixes above in place and
|
||||
computes the theme's contrast, but nothing runs a screen reader or an
|
||||
accessibility scanner, and Svelte's accessibility warnings do not fail the
|
||||
build.
|
||||
|
||||
## Supported environments
|
||||
|
||||
| Where | Runs on | Checked by hand |
|
||||
| --- | --- | --- |
|
||||
| Website | Any current browser | Chrome, Edge, Firefox and Brave on Windows 11; Safari, Chrome and Brave on iOS 26 (iPhone 14 Pro, iPhone 13 Pro Max) |
|
||||
| Desktop app | WebView2 (Windows), WKWebView (macOS), WebKitGTK (Linux) | Windows 11. The macOS and Linux builds are not checked by hand. |
|
||||
| Android app | Android System WebView, Android 11 or newer | Emulator (Android 11 to 16) and a vivo 1907 (Android 12) |
|
||||
|
||||
The apps get their accessibility from the system's web view. What a screen
|
||||
reader can do in them is roughly what it can do in Edge on Windows, Safari on
|
||||
macOS, or Chrome on Android. The full device list is in
|
||||
[`docs/pc_spec.md`](docs/pc_spec.md).
|
||||
|
||||
**Assistive technology used so far:** the keyboard alone, and the Narrator and
|
||||
NVDA screen readers on Windows. VoiceOver on a real iPhone 14 Pro (iOS 26),
|
||||
in Safari, Chrome and Brave, with the interface in English and in Vietnamese:
|
||||
passed (2026-11-09).
|
||||
**Not tried yet:** JAWS, VoiceOver on macOS, TalkBack (Android), Orca
|
||||
(Linux). Reports from any of them are especially welcome.
|
||||
|
||||
## Reporting a barrier
|
||||
|
||||
Open an issue with the
|
||||
**[♿ Accessibility barrier](https://github.com/poli0981/free-steam-games-list/issues/new?template=accessibility.yml)**
|
||||
form. You don't have to say anything about yourself or any disability: what
|
||||
you were trying to do, and what got in the way, is enough. Screenshots and
|
||||
recordings are welcome, but never required.
|
||||
|
||||
Rather not post in public, or no GitHub account? Email
|
||||
**contact@poli0981.dev**.
|
||||
|
||||
What helps, if you have it:
|
||||
|
||||
- the page: its address, or its name in the app;
|
||||
- what you tried to do, and what happened instead;
|
||||
- the browser or app, and its version. The app version is shown as
|
||||
"Steam · v…" under "F2P Tracker" in the sidebar, or in the menu on a small
|
||||
screen;
|
||||
- your operating system, and any assistive technology or setting involved
|
||||
(screen reader, zoom level, high contrast, reduced motion);
|
||||
- how much it gets in the way: you can't do it at all, it's hard or slow, or
|
||||
it's just annoying.
|
||||
|
||||
A security problem is not an accessibility report: see
|
||||
[`SECURITY.md`](SECURITY.md).
|
||||
|
||||
## What to expect
|
||||
|
||||
One person, as a hobby, in a timezone that is probably not yours. It's the same
|
||||
deal as [`SECURITY.md`](SECURITY.md).
|
||||
|
||||
- A first reply usually within a week.
|
||||
- Something that stops you using a part of the site or the apps comes first.
|
||||
Then things that make it hard or slow, then the cosmetic ones.
|
||||
- No fixed deadline for a fix. If there is a way around the problem, the reply
|
||||
says so.
|
||||
- Reports get the `accessibility` label. The issue stays open until the fix is
|
||||
live: on the website as soon as it is merged, in the desktop and Android
|
||||
apps with their next release.
|
||||
- Credit in the [CHANGELOG](CHANGELOG.md) if you want it.
|
||||
|
||||
## For contributors
|
||||
|
||||
The same rules for people and for coding agents. For any change to the
|
||||
interface:
|
||||
|
||||
- Use it with the keyboard alone. Everything should be reachable with
|
||||
<kbd>Tab</kbd>, in a sensible order, with focus always visible and nothing
|
||||
that traps it.
|
||||
- Give every control a name a screen reader can read: a visible label, or an
|
||||
`aria-label` on an icon button. Images get `alt`, empty (`alt=""`) when they
|
||||
only decorate.
|
||||
- Never say something with colour alone, or only in a hover tooltip.
|
||||
- Check it 360 px wide, at 200% zoom, in both themes, and with *reduce motion*
|
||||
on.
|
||||
- Build overlays and pop-ups on Bits UI's `Dialog` (focus trap,
|
||||
<kbd>Esc</kbd>, focus returned), not a hand-made `div`. A screen that must
|
||||
block the page reports itself in `web/src/lib/overlays.svelte.ts`, and the
|
||||
layout makes everything behind it inert.
|
||||
- Put new text in both `web/src/i18n/locales/en.json` and `vi.json`.
|
||||
- Read the accessibility warnings `npm run check` prints. CI does not fail on
|
||||
them, so nobody else will. Add no new `svelte-ignore a11y_*` without giving
|
||||
a reason in the pull request.
|
||||
- `web/src/lib/a11y.test.ts` holds the fixes listed above and the theme's
|
||||
contrast. If it fails, fix the change, not the test.
|
||||
|
||||
The [pull request template](.github/pull_request_template.md) has the short
|
||||
version as a checklist. Coding agents also follow [`CLAUDE.md`](CLAUDE.md),
|
||||
which says to keep this file true.
|
||||
|
||||
## Keeping this honest
|
||||
|
||||
- **Owner:** the maintainer, [@poli0981](https://github.com/poli0981).
|
||||
- A change that fixes a limitation above, or adds one, updates this file in the
|
||||
same pull request.
|
||||
- This file is read through again whenever an app release changes the
|
||||
interface.
|
||||
- Ideas for the statement itself go to
|
||||
[Discussions › Ideas](https://github.com/poli0981/free-steam-games-list/discussions/categories/ideas),
|
||||
or an issue.
|
||||
|
||||
*Last reviewed: 2026-11-09 (website and apps 2.5.1).*
|
||||
+8
-5
@@ -17,8 +17,11 @@ This file lives at the repo root so the author can be found without digging into
|
||||
| Everything else | <https://poli0981.dev/links/> |
|
||||
|
||||
`poli0981.dev/links/` is the single source of truth for every other channel
|
||||
— chat, socials, video, donations. It is maintained there rather than in
|
||||
— chat, socials, video. It is maintained there rather than in
|
||||
this repository so a moved or retired account cannot leave a dead link here.
|
||||
Donation links are the exception: they live in
|
||||
[`.github/FUNDING.yml`](.github/FUNDING.yml) and on the web app's
|
||||
[Donate page](https://free-steam-games.win/donate).
|
||||
|
||||
Anything that should not be public belongs in email — `contact@` unless one of
|
||||
the role addresses fits better. Security reports go to GitHub's private
|
||||
@@ -32,23 +35,23 @@ For people forking the repo or trying to reproduce a build:
|
||||
| --------------- | ------------------------------------------------------------ |
|
||||
| GitHub | [@poli0981](https://github.com/poli0981) |
|
||||
| IDE | JetBrains 2026.x — paid lineup (PyCharm, WebStorm, RustRover) |
|
||||
| Toolchains | Python 3.12 · Node.js ≥ 22 · Rust stable · Tauri 2 |
|
||||
| Toolchains | Python 3.15 · Node.js 26 · TypeScript 7 + 6 · Rust stable · Tauri 2 |
|
||||
| Git | GPG signing on (`commit.gpgsign=true`) |
|
||||
| Hardware spec | [`docs/pc_spec.md`](docs/pc_spec.md) (EN) · [`docs/i18n/vi/pc_spec.md`](docs/i18n/vi/pc_spec.md) (VI) |
|
||||
| Dev environment | [`docs/dev_env.md`](docs/dev_env.md) (EN) · [`docs/i18n/vi/dev_env.md`](docs/i18n/vi/dev_env.md) (VI) |
|
||||
| Desktop build | [`web/src-tauri/TAURI.md`](web/src-tauri/TAURI.md) |
|
||||
| Test devices | iPhone 14 Pro · iPhone 13 Pro Max · iOS 26.x (Chrome / Brave / Safari) |
|
||||
| Test devices | Windows 11 (Chrome / Edge / Firefox / Brave) · iPhone 14 Pro and 13 Pro Max, iOS 26.x (Safari / Chrome / Brave) · Android 11–16 emulator + vivo 1907 (Android 12) — full list in [`docs/pc_spec.md`](docs/pc_spec.md) |
|
||||
|
||||
## Contributors
|
||||
|
||||
Anyone who's filed an issue, opened a PR, or used the Add-Games template is implicitly thanked. The full list is whatever GitHub renders on the [contributors page](https://github.com/poli0981/free-steam-games-list/graphs/contributors).
|
||||
Anyone who's filed an issue, opened a PR, or suggested a game in Discussions is implicitly thanked. The full list is whatever GitHub renders on the [contributors page](https://github.com/poli0981/free-steam-games-list/graphs/contributors).
|
||||
|
||||
## AI assistants (full disclosure)
|
||||
|
||||
About **~70 %** of the code in this repository was generated with help from large-language-model assistants:
|
||||
|
||||
- **Grok (xAI)** — initial v1 Python pipeline (~2025).
|
||||
- **Claude (Anthropic)** — v2 refactor, full data layer, the React/Vite web app, the Tauri 2 desktop wrapper, the GPG-signing path, the legal docs, and most recent commits.
|
||||
- **Claude (Anthropic)** — v2 refactor, full data layer, the web app (React/Vite first, SvelteKit since v4), the Cloudflare Worker and `/admin`, the Tauri 2 desktop and Android apps, the legal docs, and most recent commits.
|
||||
|
||||
Generated code is reviewed and tested before each commit. No user data is sent to any LLM at runtime — LLM calls happen on the maintainer's dev machine, never from your browser.
|
||||
|
||||
|
||||
+61
-1546
File diff suppressed because it is too large.
Load diff
@@ -11,11 +11,48 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
|
||||
**Git is the source of truth for game data.** Nothing else is. Keep it that way.
|
||||
|
||||
## Project status: stable, maintenance only (since 2026-11-11)
|
||||
|
||||
The project is finished, not abandoned. The pipeline, the site and the apps
|
||||
keep running; the code no longer grows. What that means for any change:
|
||||
|
||||
- **No new features**, and no refactor or redesign for its own sake. A
|
||||
request for one is declined, whoever asks in an issue or a pull request.
|
||||
- **Code changes only for** a security advisory (CVE, CodeQL, RustSec,
|
||||
`npm audit`), a runtime or dependency update (Node, Python, Rust, npm / pip
|
||||
/ cargo packages, pinned Actions), and whatever those break. A bug or an
|
||||
accessibility barrier gets the smallest fix that closes it.
|
||||
- **Issues and pull requests from others are for the data**: add a game
|
||||
(`scripts/temp_info.jsonl`), correct one (`data/overrides/`), remove one
|
||||
(`data/blocklist.jsonl`). The issue forms are `add_game`, `edit_game`,
|
||||
`delete_game`, `bug_report` and `accessibility`; blank issues are off
|
||||
(`.github/ISSUE_TEMPLATE/config.yml`). The About page links those five by
|
||||
file name, so renaming a form is a web change.
|
||||
- The policy is stated in `README.md` ("Project status"), `CONTRIBUTING.md`,
|
||||
`SECURITY.md` and the pull-request template: change them together.
|
||||
- **Release notes are one file per release**:
|
||||
`changelog/v<major>/<major>.<minor>.x/<version>.md`, and `changelog/beta/`
|
||||
for a pre-release (none so far). `CHANGELOG.md` is the index, and keeps
|
||||
`## [Unreleased]`, where every change writes its entry. A release moves that
|
||||
section into its new file (headings one level up, relative links prefixed
|
||||
`../../../`), adds its row to its major's table and empties [Unreleased];
|
||||
what the file says below its title and back link is the GitHub release's
|
||||
notes. A released file is not reworded afterwards.
|
||||
- Every rule below still holds. Maintenance mode is when they matter most:
|
||||
the next change will be made by someone who has not touched the code for
|
||||
months.
|
||||
|
||||
## Data invariants — get these wrong and you corrupt the dataset
|
||||
|
||||
- **`appid` is not a stored field.** It is parsed out of `link` with
|
||||
`/\/app\/(\d+)/` (`web/src/lib/data-store.ts`, `extract_appid` in
|
||||
`scripts/core/data_store.py`). Never add it as a column; derive it.
|
||||
`scripts/core/data_store.py`). Never add it as a column; derive it. It is
|
||||
ASCII digits on both sides: JavaScript's `\d` is ASCII, Python's is not, so
|
||||
`extract_appid` refuses a run of digits with any non-ASCII one in it
|
||||
(`/app/730٤` is `None`, never 730) and `normalize_link()` reads a queued line
|
||||
through NFKC first, which turns a Japanese keyboard's `5118700` into
|
||||
5118700. A non-ASCII appid would miss every comparison and make
|
||||
`rotation.slice_of()` (`.encode("ascii")`) stop every refresh.
|
||||
|
||||
- **Numeric-looking fields are formatted strings, not numbers.**
|
||||
`current_players: "492,197"`, `reviews: "86% (Very Positive)"`,
|
||||
@@ -67,6 +104,13 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
field an active override covers, or a retired entry's value, would be undone
|
||||
by `apply_overrides()` and bump `last_updated` on every run.
|
||||
|
||||
One stored genre is not a judgement: a value in `NOT_GENRES` ("Free To
|
||||
Play", "Early Access"; `constants.py`), a price model or a release state.
|
||||
Until v4.6.0 the skip list matched appdetails' names case-sensitively and
|
||||
1,357 games were stored with "Free To Play". `fetcher.pick_genre()` compares
|
||||
casefolded and never falls back to one, and Refresh Store Data replaces a
|
||||
stored one (`is_stray_genre()`) from appdetails, guarded like any writer.
|
||||
|
||||
- **`data/overrides/<appid>.json` is human intent, and it is permanent.**
|
||||
`apply_overrides()` is called from inside `save_main()` — the single choke
|
||||
point through which all 15 data-writing scripts pass, and the only code that
|
||||
@@ -183,6 +227,14 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
`error`: Chromium's failed AES-GCM decrypt is a DOMException with an
|
||||
EMPTY message, and `if (error)` once resolved a damaged pack as a shard
|
||||
with no records (`worker-pool.test.ts`, `jsonl-parser.test.ts`).
|
||||
- The worker refuses a message whose origin is non-empty and not its own
|
||||
(`if (e.origin && e.origin !== self.location.origin)`), replying with an
|
||||
error. The owner's messages arrive over the dedicated worker's implicit
|
||||
port with origin `""`, so `e.origin &&` is load-bearing: without it every
|
||||
message would be refused. The `!==` on `e.origin` is what CodeQL's
|
||||
`js/missing-origin-check` recognises; dismissing that alert instead does
|
||||
not last, because it reopens as a new alert whenever the handler moves
|
||||
(#3 dismissed, #20 reopened, 2026-10-03).
|
||||
- Obfuscation and compression (~1.4 MB stored instead of ~9.5 MB of
|
||||
objects), never protection - the key is public, like the wire packs'.
|
||||
|
||||
@@ -214,15 +266,28 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
(tags, languages, `language_details`, `has_paid_dlc`) every 7 days,
|
||||
appdetails (name, header image, description, developer/publisher, release
|
||||
date, platforms, Metacritic, DRM notes) every 30. Never `appid % cycle`:
|
||||
appids are mostly multiples of 10, which leaves most slices empty. It
|
||||
appids are mostly multiples of 10, which leaves most slices empty. A cycle
|
||||
grows with the catalogue instead of the run (`rotation.cycle_for()`: past
|
||||
`PAGE_DAILY` 2,000 pages or `DETAILS_DAILY` 500 appdetails a day it becomes
|
||||
14, 21, ... or 60, 90, ...) and is always a MULTIPLE of its base, so a game
|
||||
keeps its weekday and its day of the month and visits only ever thin out.
|
||||
The slice is visited in `rotation.daily_order()`, so a run that meets its
|
||||
time budget leaves a different tail each day. It
|
||||
replaces values only with NON-EMPTY ones, never writes `MANUAL_FIELDS` or
|
||||
`notes`, trusts `has_paid_dlc` only from a real store page (an age gate has
|
||||
`notes` - except a stray genre (above), read from appdetails every day,
|
||||
first after the page repairs, at most `GENRE_DAILY_CAP` a day, and left
|
||||
alone under an override - trusts `has_paid_dlc` only from a real store page (an age gate has
|
||||
no language table or tags) or a gated game's DLC prices, compares every
|
||||
value as stored (normalised, `description` truncated - and a blurb merely
|
||||
cut off later, now that `"` is one character, is written without
|
||||
counting as news), and bumps `last_updated` only on a real change. A game
|
||||
cut off somewhere else is written without counting as news: later, now
|
||||
that `"` is one character, or earlier, at a CJK sentence end since
|
||||
v4.6.0; `_fuller_cut()` takes two cuts of one text, never a rewrite), and
|
||||
bumps `last_updated` only on a real change. A game
|
||||
with empty tags, languages or `language_details` is in the page group EVERY
|
||||
day, first, capped at `MISSING_DAILY_CAP`; `--missing-only` runs just those.
|
||||
A game whose appdetails no longer call it free is LISTED in a `::warning::`,
|
||||
never written: purge removes a game only when the store API flags it too,
|
||||
and this is where the opposite case shows.
|
||||
A new field added to it must obey the same rules;
|
||||
`scripts/tests/test_refresh_store_data.py` holds them.
|
||||
- **A store page behind Steam's age gate is never parsed.** An 'Adult Only'
|
||||
@@ -244,7 +309,8 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
with `l=english`: without it, a runner was once answered in Russian.
|
||||
- **`all_time_peak` only ever goes UP, and `refresh_peaks.py` is what raises
|
||||
it** (daily 19:30 UTC, "Refresh All-Time Peaks"). A `crc32(appid) % 30`
|
||||
slice (`core/rotation.py`, shared with `refresh_store_data.py`) reads
|
||||
slice (`core/rotation.py`, shared with `refresh_store_data.py`; 60, 90, ...
|
||||
past `PEAK_DAILY` 400 pages a day, never shorter) reads
|
||||
SteamCharts' recorded all-time peak - the only source older than our own
|
||||
sampling: SteamDB forbids scraping and Valve's APIs know only today. Every
|
||||
run also raises it from our samples (`peak_today`, which despite its name is
|
||||
@@ -252,8 +318,9 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
`apply_players()` raises it on every sample, never from a 0. SteamCharts has
|
||||
no API, terms or robots.txt, so: one page per game a month, 2-3 s apart, a
|
||||
User-Agent that names the project; 500 is an app it does not track (most of
|
||||
the long tail), 404 one it has never seen; a 403, 429 or challenge page
|
||||
stops the run with a warning, not a failure. `refetch_all.py` must never
|
||||
the long tail), 404 one it has never seen; a 403, 429 or challenge page,
|
||||
or the job's time budget, stops the run with a warning, not a failure.
|
||||
`refetch_all.py` must never
|
||||
clear the field - it cannot be fetched again - and nothing may lower it.
|
||||
The backfill is a manual run with `backfill` ticked (~4 h, start it in the
|
||||
evening UTC). DISCLAIMER section 6 names the source, so rewording it reopens
|
||||
@@ -285,6 +352,47 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
name and the new key are the same family, and a known label stays as it was
|
||||
written (so "Easy Anti-Cheat" and "EAC" both occur; the site groups them).
|
||||
`scripts/tests/test_anticheat.py` and `test_refresh_anticheat.py` hold it.
|
||||
- **Reviews are Steam's own summary, read for EVERY game daily**
|
||||
(`update_reviews.py`, "Update Reviews" 06:00): `GetItems` with
|
||||
`include_reviews`, fifty games a request (`SteamClient.fetch_items()`, the
|
||||
sweep the anti-cheat and purge jobs share), ~2 minutes. It asked
|
||||
`appreviews` one game at a time until v4.4.0 and, at 9,800 games, ran into
|
||||
GitHub's six-hour limit with nothing saved. Rules: the percentage is Steam's,
|
||||
FLOORED (`reviews_from_summary()` floors appreviews in integers too, so an
|
||||
ingest and the refresh agree; until v4.4.0 it was rounded, one point higher
|
||||
on ~40% of games); a GetItems count of 0 never replaces a percentage - its
|
||||
summary has said 0 for a game with thousands (845070) - so such a game is
|
||||
asked on appreviews (`ASK_CAP` 300 a run, daily order) and keeps its value
|
||||
when that gives no answer; "N/A" (never read) with a count of 0 becomes
|
||||
"No reviews"; no item, no usable summary or a failed batch keeps the value.
|
||||
**appreviews has answered with a 302 to the store front since 2026-10-23**
|
||||
(from here and from GitHub's runners; it worked on 10-17), so `fetch_full()`
|
||||
falls back to the same GetItems summary (`reviews_from_store_api()`) and an
|
||||
ingest no longer leaves "N/A". A record's `last_updated` moves on a change
|
||||
and on a HEARTBEAT: a
|
||||
game read whose stamp is 14-20 days old (crc32 jitter) is stamped again.
|
||||
The site calls a record older than 30 days stale (`web/src/lib/validation.ts`,
|
||||
`/health`), and this job used to stamp every game on every run; the
|
||||
heartbeat keeps "the pipeline confirmed this lately" true without rewriting
|
||||
every record daily. `scripts/tests/test_update_reviews.py` holds it.
|
||||
- **A game is purged only when two of Steam's answers agree**
|
||||
(`purge_unhealthy.py`, "Purge Unhealthy Games" daily 07:00). GetItems
|
||||
screens the whole catalogue (`store_items.screen_item()`: unknown to Steam,
|
||||
`visible` false, `unlisted`, `release.is_coming_soon`, no `is_free`; never
|
||||
`type` - a free mod is listed on purpose), and `check_game_health()`
|
||||
(appdetails) must confirm each flag. An `unavailable`/404 answer is asked
|
||||
again `RECHECK_AFTER` (5 min) later: appdetails answered `success:false` for
|
||||
14 live games in two bursts on 2026-09-27. A failed batch or a network error
|
||||
is never "gone"; blocklisted games are not asked about. More than 500 flags
|
||||
or 100 confirmed removals exits non-zero BEFORE anything is written
|
||||
(`--max-candidates`, `--max-removals` to override). Removals are logged to
|
||||
`removed_games.jsonl` exactly as before - `reconcile.ts` reads them. A
|
||||
`::notice::` names earlier removals GetItems now sees free, listed and
|
||||
released (re-queue the link to bring one back: a purged game keeps its D1
|
||||
decision and discovery never proposes it again). Check Dead Links is gone:
|
||||
HEAD on a delisted app's page ends on the store front with 200, so in its
|
||||
whole life it never found a dead link, and it took 5.5 hours.
|
||||
`scripts/tests/test_purge_unhealthy.py` holds it.
|
||||
- `ingest_new.py` only reads `scripts/temp_info.jsonl`, and a line is a store
|
||||
LINK and nothing else: every other key is ignored and the game is built from
|
||||
Steam (`merge_extension_data()` went with the archived browser extension;
|
||||
@@ -297,20 +405,47 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
appdetails calls other than `type: "game"` (`status_code: not_a_game` in
|
||||
`removed_games.jsonl`) - the check that makes auto-approve safe, and why a
|
||||
queued link cannot add a free DLC, demo or tool. The check lives in ingest
|
||||
only: in `health_checker` it would make Purge delete old records every week.
|
||||
only: in `health_checker` it would make Purge delete old records every day.
|
||||
- **`ingest-new.yml` is also the removal job.** `bash/ingest.sh` runs
|
||||
`remove_games.py` (applies `data/blocklist.jsonl`) and then
|
||||
`ingest_new.py`, and commits once ("Apply removals" when `temp_info` did not
|
||||
change). A separate removal workflow would keep evicting the ingest from
|
||||
`data-write`'s single pending slot, and the ingest it. The workflow checks
|
||||
out `ref: main`, not the triggering SHA: a run that waited its turn would
|
||||
otherwise work on the data as it was when it was queued.
|
||||
change), so one commit to either file starts one run that settles both.
|
||||
The workflow checks out `ref: main`, not the triggering SHA, like every
|
||||
data-write workflow: a run that waited its turn would otherwise work on the
|
||||
data as it was when it was queued. It has no time budget: `clear_temp()`
|
||||
empties the whole queue file, so a game it had not reached would be lost.
|
||||
- New games ARE discovered automatically now, by `scripts/discover_new.py`
|
||||
into the D1 review queue — but discovery only PROPOSES. Publication is
|
||||
decided in `/admin`: by a reviewer, batch by batch, or by the auto-approve
|
||||
rule a reviewer turned on there (off by default, at most 500 a day). Either
|
||||
way it is a REQUEST in `temp_info.jsonl` that `ingest_new.py` still checks
|
||||
game by game.
|
||||
- **Discovery takes games in every language** (since v4.6.0). The store search
|
||||
(`SteamClient.fetch_search_page()`) sends no `supportedlang`; pinned to
|
||||
english it left out 1,592 of 18,790 free games (2026-10-30), mostly Chinese,
|
||||
Japanese or Korean only, and without it Steam filters on no language at all.
|
||||
Rules that are easy to break:
|
||||
- The search sends `l=english`. It fixes the language of the row TEXT, never
|
||||
which rows come back: discovery skips a row whose release reads "Coming
|
||||
soon" and the backfill parses English month names.
|
||||
- Every other request still asks Steam in English, so tags, genre, language
|
||||
names, review labels and dates stay English; a name or description the
|
||||
developer never wrote in English stays in their script. That is the
|
||||
record, not a parsing error.
|
||||
- A candidate's payload carries `languages` (appdetails'
|
||||
`supported_languages`, read by `appdetails_languages()`), which `/admin`
|
||||
shows with a "No English" badge. Auto-approve treats such a game like any
|
||||
other. Rows queued earlier have no list: the Worker never rewrites a
|
||||
queued row's `payload_json`.
|
||||
- Both workflows' guard step greps the two discovery scripts for
|
||||
`save_main|save_jsonl|clear_temp|fetch_full` as WORDS, comments and
|
||||
docstrings included: none of the four may appear in them at all.
|
||||
- The `discovery` group queues (`queue: max`) in both of its workflows, so
|
||||
backfill windows dispatched together wait in turn instead of cancelling
|
||||
each other; `pipeline.test.ts` holds a group to one setting.
|
||||
- A game that declares no language (29 of them) has empty `languages` once
|
||||
ingested: Refresh Store Data's repair group takes it every day and the
|
||||
admin Quality page flags it. Accepted.
|
||||
- **Auto-approve (`worker/lib/auto-approve.ts`, run by the cron after
|
||||
reconcile) commits a batch only when every gate says yes**, and a gate it
|
||||
cannot evaluate says no: enabled (or "Run one batch now"), its D1 lease,
|
||||
@@ -321,8 +456,10 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
page previews is the SQL that runs). The empty-file gate is checked again
|
||||
inside the commit (`requireEmptyQueue`), so a batch never lands mid-ingest;
|
||||
"no row is approved" would have stalled it for the 12 hours a skipped row
|
||||
stays approved. The idle gate exists because a push while a data job waits
|
||||
EVICTS that job. `shared/pipeline.ts` lists every `data-write` workflow by
|
||||
stays approved. The idle gate dates from when a push while a data job waited
|
||||
EVICTED that job; with `queue: max` the ingest would only queue behind it,
|
||||
and the gate stays so a batch lands when its ingest can start at once.
|
||||
`shared/pipeline.ts` lists every `data-write` workflow by
|
||||
file, and `pipeline.test.ts` fails when a workflow joins the group without
|
||||
joining the list. Settings, limits and their validation are
|
||||
`shared/automation.ts`, imported by the Worker and the page. A scheduled
|
||||
@@ -381,20 +518,73 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
it must keep excluding). `geo.ts` FAILS OPEN on an unknown country:
|
||||
`request.cf` is undefined under Vitest and under `wrangler dev` without
|
||||
`--remote`, and failing closed there 403s every test.
|
||||
- **Rate limiting has two layers, and the WAF rule is the first.** The zone's
|
||||
one Free-plan rate-limiting rule (IP, 10 s, Block 10 s; `docs/SECURITY_SETUP.md`
|
||||
§3a) refuses a burst before the Worker is invoked, and is the only limit on
|
||||
the prerendered pages. `worker/lib/rate-limit.ts` is the second: the
|
||||
`ratelimits` bindings in `wrangler.jsonc`, 60-second windows, one budget per
|
||||
surface (`RL_DATA`, `RL_IMG`, `RL_API`, `RL_HUMAN`, `RL_ADMIN`), keyed by
|
||||
IPv4 address or IPv6 /64, checked after the country block and before every
|
||||
route and the Access check, answering 429 with `Retry-After: 60`. Rules:
|
||||
- It FAILS OPEN (no binding, no `CF-Connecting-IP`, a throwing `limit()`).
|
||||
Vitest and `admin/mock` bind no limiter, which is why no other test sees
|
||||
it; the catalogue must never fail to load because of this layer.
|
||||
- Counts are effectively PER SERVER, whatever the docs say about
|
||||
"per location" (measured 2026-10-27, SIN): over one keep-alive connection
|
||||
a budget held exactly (121 then 429), with a new connection per request
|
||||
it refused nothing (175 human checks in 70 s against 20). So it stops
|
||||
browsers and connection-reusing scripts; a client that reconnects every
|
||||
time is the WAF rule's (which counted exactly 250). A limit is an abuse
|
||||
ceiling far above any client (a cold catalogue load is ~16 data
|
||||
requests), never a quota to tighten. Test it over ONE connection
|
||||
(`SECURITY_SETUP.md` §3b), or it looks broken.
|
||||
- Refusals are not logged: Workers Logs has the 429 status, and a line each
|
||||
would double a flood's log volume.
|
||||
- A 429 carries CORS only where its route does (`data`, `api`), never on the
|
||||
human check or the admin surface.
|
||||
- Every `period` stays 60 (the Retry-After), and a `namespace_id` is unique
|
||||
in the ACCOUNT - another Worker reusing one shares its counters. A new
|
||||
`run_worker_first` prefix needs a class, and a new binding needs its line in
|
||||
`worker-configuration.d.ts`. `rate-limit.test.ts` holds the periods, the
|
||||
namespaces, the binding names and the prefix coverage.
|
||||
- `audit_log` and `commit_jobs` are pruned daily after `ADMIN_RETENTION_DAYS`
|
||||
(wrangler.jsonc, 180). `docs/PRIVACY_POLICY.md` states the number: change
|
||||
both together. `ingest_queue` and `ingest_decisions` are never pruned — the
|
||||
decisions are what keep a rejected game out of the discovery sweep.
|
||||
- Every workflow that writes to `data/` shares `concurrency: {group: data-write}`.
|
||||
A new data-writing workflow without it will race jobs that run ~2 hours.
|
||||
The group holds ONE pending run - a second queueing run cancels the first -
|
||||
and scheduled runs here start 2-5 hours after their cron, so a new schedule
|
||||
goes where nothing long is running (the long jobs - reviews, dead links,
|
||||
purge - start mid-morning UTC and run 2-4 hours; Refresh Store Data is at
|
||||
16:00 for that reason).
|
||||
- **Every workflow that writes to `data/` shares `concurrency: {group:
|
||||
data-write, cancel-in-progress: false, queue: max}`, checks out `ref: main`,
|
||||
and declares `timeout-minutes`.** `pipeline.test.ts` fails on a data-write
|
||||
workflow without any of them. A new data-writing workflow outside the group
|
||||
would race the others.
|
||||
- `queue: max` (GitHub, 2026-05-07) keeps up to 100 runs waiting, first in,
|
||||
first out. The default keeps ONE: a run queueing behind a running job
|
||||
cancelled the one already waiting - Update Reviews lost five of ten runs
|
||||
that way in October 2026. Mixing the two settings in one group is
|
||||
undocumented, so every member has `queue: max`.
|
||||
- `ref: main`: a run's commit is fixed when the run is CREATED. A scheduled
|
||||
run that waited behind another data job wrote shards from before that
|
||||
job's commit, and `commit_push.sh`'s rebase then conflicted on
|
||||
`data/index.json` - Auto Update JSON failed four days in ten that way.
|
||||
- Scheduled runs start up to an hour after their cron (2-5 hours in
|
||||
September). Waiting costs nothing now, but a long new job still goes where
|
||||
nothing long runs (Refresh Store Data is at 16:00 for that reason).
|
||||
- **Every long loop has a time budget** (`scripts/core/budget.py`). The
|
||||
workflow sets `JOB_BUDGET_MINUTES` at least 20 below its `timeout-minutes`
|
||||
(`pipeline.test.ts` checks); past it a loop starts no further game, the
|
||||
script saves what it did and the job commits it, and a loop that used more
|
||||
than three quarters says so in a `::warning::`. Loops visit their games in
|
||||
`rotation.daily_order()`, so a cut falls elsewhere the next day. A job
|
||||
stopped at its timeout commits nothing and concludes `cancelled`, which
|
||||
`notify-ci-failure.yml` (a reusable workflow in `poli0981/.github`) does not
|
||||
report: the budget is what keeps a growing catalogue from failing silently.
|
||||
`process_batch(pause=False)` for the keyed Web API (player counts); the
|
||||
15-30 s rest between batches stays for store pages and appdetails. Never a
|
||||
budget for `ingest_new.py`. `refetch_all.py` runs in parts (`--part K/N`)
|
||||
and clears each game on a copy that replaces it only once appdetails has
|
||||
answered, so a cut part leaves every other game as it was.
|
||||
- **Every data job commits through `bash/commit_push.sh`.** The group
|
||||
serialises workflows, not `main`: a merged PR or an /admin commit can land
|
||||
during a four-hour job, and a bare `git push` is then rejected and the run
|
||||
during a long job, and a bare `git push` is then rejected and the run
|
||||
thrown away (purge-unhealthy, 2026-09-21). The helper rebases onto
|
||||
`origin/main` and retries; none of those writers touch the shards, so the
|
||||
rebase is clean. A new wrapper must use it, once per commit (Refresh Store
|
||||
@@ -402,6 +592,106 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
- Workflows push with the built-in `GITHUB_TOKEN`; each declares
|
||||
`permissions: {contents: write}`. Do not reintroduce a PAT — a PAT expiring
|
||||
silently is what stalled the pipeline for a month in 2026.
|
||||
- **CI installs only what is pinned, and runs no dependency's install code.**
|
||||
These jobs hold a write token, and the release jobs the signing keys.
|
||||
- Third-party actions are pinned to a commit SHA with the version in a
|
||||
comment (`@<sha> # v2.9.2`), which Dependabot's github-actions updates
|
||||
keep current. `dtolnay/rust-toolchain` is pinned to a MASTER commit and
|
||||
given `toolchain: stable`: its other branches are regenerated on top of
|
||||
master, so a commit of `stable` can vanish. GitHub's own actions
|
||||
(`actions/*`, `github/*`) and `poli0981/.github` stay on tags.
|
||||
- Every `npm ci` is `npm ci --ignore-scripts`, and no workflow uses `npx`
|
||||
(`npm run cf:check`, `npm test -- <file>`). Only fsevents, workerd and
|
||||
wrangler's esbuild have install scripts, and none is needed: the last two
|
||||
find their binary in their optional platform package anyway. A new
|
||||
dependency whose install script IS needed breaks the build here - which
|
||||
is the point; decide then, do not drop the flag.
|
||||
- `requirements.txt` pins every package the pipeline installs, transitive
|
||||
ones included, with the sha256 of every file on PyPI, and every install
|
||||
is `pip install --require-hashes --only-binary :all: -r requirements.txt`
|
||||
(bash/*.sh and the workflows that run Python). Hash mode is all-or-nothing
|
||||
per pip call: `requirements-test.txt` (pytest and pytest-cov, hashed the
|
||||
same way) goes in its own call in `python-tests.yml` and
|
||||
`sonarcloud.yml`, which run the pipeline's line first so a
|
||||
Dependabot bump is proven before a data job meets it, and
|
||||
`requirements-dev.txt` (unhashed local tools) is installed on its own.
|
||||
Adding a package means adding it and its dependencies with hashes:
|
||||
`uv pip compile --universal --generate-hashes --python-version 3.15`.
|
||||
- **One version of each runtime, and a test that holds them together**
|
||||
(`web/shared/toolchain.test.ts`; web-ci also runs on `.github/workflows/**`
|
||||
and `sonar-project.properties` so a pull request that only moves a pin meets
|
||||
it). `docs/plan/16-toolchain-2026.md` has the upgrade notes.
|
||||
- Node is the major in `web/.node-version` (26). Every `setup-node` repeats
|
||||
it as a quoted literal, never `node-version-file`: `release-android.yml`
|
||||
checks out the tag it rebuilds, and older tags have no such file.
|
||||
`engines.node` and the `@types/node` major follow it. Workers Builds
|
||||
reads the dashboard variable `NODE_VERSION=26`, the one copy the test
|
||||
cannot see (`docs/DEPLOYMENT.md`): change it with the file.
|
||||
- Python is the `python-version` of every `setup-python` (3.15), repeated
|
||||
by `sonar.python.version` and the `--python-version` above. `codeql.yml`
|
||||
alone stays on the newest Python CodeQL lists (3.14), named in the test's
|
||||
`PYTHON_EXCEPTIONS`. A version is always quoted: YAML reads 3.10 as 3.1.
|
||||
- Python 3.15 makes `open()` default to UTF-8 everywhere (PEP 686), but every
|
||||
text open in `scripts/` still names `encoding="utf-8"`: on Windows an
|
||||
older Python writes the locale's code page, and cp1252 cannot encode the
|
||||
leaderboards' emoji.
|
||||
- **SonarCloud analyses in CI (`sonarcloud.yml`), and its scope is
|
||||
`sonar-project.properties`.** Automatic analysis is OFF in the project's
|
||||
Administration > Analysis Method and must stay off: while it is on, every CI
|
||||
scan fails. The scanner reads the file from the commit it analyses. Code and
|
||||
tests both start at the root and are split by patterns: a new test-helper
|
||||
folder goes into `sonar.test.inclusions` AND `sonar.exclusions`, or it is
|
||||
analysed as code (and a file both include fails the scan). It leaves out the
|
||||
dataset, generated Android resources and the SQLite migrations (the PL/SQL
|
||||
analyser reads them as Oracle). `sonar.typescript.tsconfigPaths` names all
|
||||
six tsconfigs in `web/` (auto-detection finds only files named exactly
|
||||
`tsconfig.json`), and the job runs `npm ci --ignore-scripts` and
|
||||
`npm run build:admin` (which syncs SvelteKit) first: `web/tsconfig.json`
|
||||
extends the generated one, and without it the analyser logged "Failed to
|
||||
parse tsconfig" and read `web/src` untyped. A new tsconfig joins that list.
|
||||
The job skips commits that touch only what the data jobs write, and its
|
||||
`scan` job is skipped when `SONAR_TOKEN` is not available (forks,
|
||||
Dependabot).
|
||||
**Coverage is measured there, not in the test workflows.** The job runs
|
||||
pytest with `--cov` (`[tool.coverage.run]` in `pyproject.toml`: `scripts/`
|
||||
without its tests, relative paths, `coverage.xml` at the root) and
|
||||
`npm run test:coverage` (`test.coverage` in `web/vite.config.ts`: lcov with
|
||||
`projectRoot: ".."`, so the paths start `web/`). Both reports are named in
|
||||
`sonar-project.properties`; a path that does not resolve from the
|
||||
repository root is silently uncovered. Coverage is off for a plain
|
||||
`npm test`. The default "Sonar way" gate wants 80% on new code, and SonarCloud
|
||||
counts every executable line a report does not name as uncovered: without
|
||||
the reports `main` read 0.0% and failed it (2026-10-22). Suppressing a rule
|
||||
for a file is done in the SonarCloud UI, not in this file or with NOSONAR.
|
||||
- **Qodana analyses in CI too (`qodana.yml`), one Qodana Cloud project and
|
||||
token per linter**: `qodana-python` over `scripts/` (`QODANA_TOKEN_PYTHON`),
|
||||
`qodana-js` over `web/` (`QODANA_TOKEN_TS_JS`), `qodana-rust` over
|
||||
`web/src-tauri/` (`QODANA_TOKEN_RUST`), the setup free-games-itchio-list
|
||||
uses. Each project's settings are the `qodana.yaml` in its directory, with
|
||||
a gate of zero problems (`failureConditions`): a new finding fails its job,
|
||||
so fix it, or exclude the inspection there WITH its reason. All three need
|
||||
an Ultimate licence (a trial in November 2026; the Rust linter is Early
|
||||
Access): when it ends every job fails on it - renew, or delete
|
||||
`qodana.yml` and the three `qodana.yaml`. What the first runs cost:
|
||||
- Native `qodana-python` finds no interpreter by itself (`SDKs.json`
|
||||
empty, then every `dict[int, str]` and `X | None` is an "invalid type
|
||||
hint"): the job builds `.venv` and passes `QODANA_PYTHON_PATH`.
|
||||
`scripts/` is the project directory because `core` resolves only there.
|
||||
- The `qodana-rust` image has no C linker and none of Tauri's libraries,
|
||||
and runs as the runner's user ("Analysis scope: 0 packages", a Critical
|
||||
"Cargo project loading"): `-u root -e CARGO_HOME=/data/cache/cargo`, a
|
||||
`bootstrap` that installs the packages, and a stand-in
|
||||
`web/dist/index.html` so `generate_context!()` expands. It calls
|
||||
`serde_json` unused; the expansion needs it (`::serde_json::Value`).
|
||||
- `qodana-js` runs in Docker, not native: a `plugins:` entry (the Svelte
|
||||
plugin, without which no `.svelte` file is read) fails to install in
|
||||
native mode with every released CLI up to 2026.2.3 (QD-16701). With it,
|
||||
every `@lucide/svelte/icons/*` import reads as unused, so
|
||||
`ES6UnusedImports` is off (`noUnusedLocals` covers it).
|
||||
- A subdirectory project needs `--project-dir <dir> --repository-root .`,
|
||||
and each job its own cache keys (the default is one key per run). The
|
||||
SARIF and logs are the `qodana-report-*` artifact, a zip inside the
|
||||
artifact; `gh run view --log` is empty until the whole run has ended.
|
||||
|
||||
## Frontend gotchas
|
||||
|
||||
@@ -464,6 +754,14 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
is under the clock again (the cure is a WebView update, or a native inset
|
||||
listener in `MainActivity`). `mobile-layout.test.ts` holds the shell and the
|
||||
strip's two colours.
|
||||
- **The Android app opts out of Auto Backup** (`android:allowBackup="false"`
|
||||
in `gen/android/app/src/main/AndroidManifest.xml`, from 2.2.1). Unset, it
|
||||
defaults to true, and Android copied the WebView's storage - consent,
|
||||
settings, the cached catalogue - to the user's Google account, while
|
||||
`docs/PRIVACY_POLICY.md` says none of it leaves the device. Fix the app,
|
||||
not the policy: a policy edit reopens the consent gate for everyone.
|
||||
Device-to-device transfer on Android 12+ still carries the data, which is
|
||||
the user's own copy between their own phones.
|
||||
- **Every chart colour must be one zrender can parse, which is stricter than
|
||||
what a canvas paints.** zrender splits `hsl()` on commas: space-separated
|
||||
`hsl(38 94% 60%)` paints, but every hover state derived from it comes back
|
||||
@@ -492,14 +790,83 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
- `echarts-wordcloud` declares a stale `echarts@^5` peer. It runs fine on
|
||||
echarts 6 (all the legacy APIs it uses are still exported), so `package.json`
|
||||
carries an `overrides` entry. Do not "fix" it by pinning echarts back to 5.
|
||||
- **The `"@sveltejs/kit@2.70.3": { "cookie": "^0.7.2" }` override closes
|
||||
GHSA-pxg6-pf52-xh8x** (kit 2 declares `cookie ^0.6.0`; only kit 3 moved on).
|
||||
Kit imports just `parse`/`serialize`, which 0.7 keeps, and under
|
||||
adapter-static that code runs only at prerender and in `vite dev`. The key
|
||||
names kit's EXACT version because npm refuses a range key for a direct
|
||||
dependency (`EOVERRIDE`). A kit bump therefore silently drops the override
|
||||
and the alert comes back: re-key it, or delete it once kit asks for
|
||||
`cookie` >= 0.7. Never carry it onto kit 3, which needs `cookie` 2.
|
||||
- `runed` 0.35 (bits-ui's) declares an optional `@sveltejs/kit ^2.21.0` peer,
|
||||
which npm enforces once kit is installed, so `package.json` overrides it to
|
||||
our kit. bits-ui uses none of runed's kit code (`useSearchParams`, the only
|
||||
part runed 0.38 changed for kit 3). Drop the entry once bits-ui depends on
|
||||
runed >= 0.38.
|
||||
- **SvelteKit 3 takes its options from its Vite plugin.** They are
|
||||
`sveltekitConfig(tauri)` in `web/build/sveltekit-config.ts`, which
|
||||
`vite.config.ts` passes as `sveltekit(sveltekitConfig(IS_TAURI))`;
|
||||
`sveltekit-config.test.ts` holds both flavours. `svelte.config.js` is
|
||||
refused (the build stops while the file exists), and what was `kit.*` there
|
||||
is a top-level option (`adapter`, `csp`, `paths`, `prerender`). Rules that
|
||||
are easy to break:
|
||||
- **`$lib` is gone; `#lib/*` is package.json `imports`.** A module import
|
||||
names `.js` even for a `.ts` file (`#lib/utils.js`), a component its
|
||||
`.svelte`. `tsconfig.json` repeats the mapping in `paths`, because
|
||||
`svelte-check --tsgo` redirects `.svelte` imports to the declarations it
|
||||
emits only through `paths`: without it every `#lib` component fell back to
|
||||
the `*.svelte` shim - props unchecked, no error.
|
||||
- **`src/params.ts` is imported by Node itself** (`vite build` uses
|
||||
`import()`, not Vite), so it and what it imports (`lib/legal.ts`,
|
||||
`lib/schema.ts`) name real `.ts` files and stay type-strippable; a `.js`
|
||||
or extensionless import there is ERR_MODULE_NOT_FOUND at build time.
|
||||
- **The PWA is `build/pwa.ts`**: vite-plugin-pwa wired into kit 3's
|
||||
`buildApp`. @vite-pwa/sveltekit never supported kit 3; it wrote the worker
|
||||
when the SERVER build closed, which kit 3 does first. Ours writes it in a
|
||||
default-order `buildApp` hook placed after `sveltekit()` - after kit's
|
||||
build-and-prerender, before the adapter's `post` hook copies
|
||||
`.svelte-kit/output/client` into `dist/`. Placed before `sveltekit()`, it
|
||||
would glob an empty output.
|
||||
- `goto` options are `replace` (not `replaceState`), `reset: false` (not
|
||||
`noScroll`/`keepFocus`, which THROW in dev) and `refreshAll` (not
|
||||
`invalidateAll`); `/games` writes its filters with `goto(url, {shallow:
|
||||
true, replace: true})`. `goto` rejects a URL that matches no route.
|
||||
- Hook types come from `@sveltejs/kit/hooks`. The client `handleError` gets
|
||||
`{kind, error, event}` for every error and returns nothing to keep kit's
|
||||
own status and message.
|
||||
- `version.pollInterval` is kit's default (an hour), and kit also checks
|
||||
`/_app/version.json` whenever the tab regains focus. A new version only
|
||||
sets `updated.current`; a navigation that then fails reloads natively.
|
||||
- **miniflare pins undici EXACTLY**, so an undici advisory in `npm audit`
|
||||
waits for a wrangler whose miniflare pins the fixed version. undici runs
|
||||
only in local tooling (`wrangler dev`, `cf:check`), never in the deployed
|
||||
Worker. A bridging override (`"miniflare": { "undici": "^x" }`) goes in the
|
||||
same commit that takes wrangler to such a release - left behind, it would
|
||||
hold undici on its major after miniflare moves on. The one for
|
||||
GHSA-xjj6-f33q-929c went with wrangler 4.156.0 (`npm ls undici`: 7.30.1,
|
||||
miniflare's own pin).
|
||||
- **The `"workbox-build": { "glob": "^14.0.2" }` and
|
||||
`"filelist": { "minimatch": "^11.0.1" }` overrides close
|
||||
GHSA-3g3m-2fjr-6pw4 and GHSA-g3hv-75wg-m249** (2026-10-30), fixed only in
|
||||
the new majors. workbox-build 7.4.1 asks glob `^11` and calls only
|
||||
`globSync(pattern, {cwd, follow, ignore})`, which glob 14 keeps; its one
|
||||
break that could touch us, an `ignore` starting with `/`, matches nothing
|
||||
in `vite.config.ts` or `build/pwa.ts`. The precache was compared URL by
|
||||
URL before and after (172 = 172). filelist is reached only through ejs's
|
||||
CLI (`ejs` → `jake` → `filelist`); the off-main-thread plugin calls
|
||||
`ejs.render`, which never loads jake. Delete each override once
|
||||
`npm ls glob minimatch` shows no version below the fixed one without it.
|
||||
`deepmerge` (GHSA-gcqx-w48m-w2h4, low) has no fixed release at all; it
|
||||
merges our own Vite/rollup config at build time, and its alert is
|
||||
dismissed as tolerable risk.
|
||||
- **TypeScript is two packages, on purpose.** TypeScript 7 (the Go compiler)
|
||||
has no JavaScript API, and svelte-check and `svelte-kit sync` (route
|
||||
`$types`) need one, so `typescript` stays 6 and 7 is the alias
|
||||
`@typescript/native` (`npm:typescript@~7.0.x`). svelte-check `--tsgo` finds 7
|
||||
by that name and runs its bin; the `tsc -p` steps call
|
||||
`node node_modules/@typescript/native/bin/tsc` by path, because both
|
||||
packages declare a `tsc` bin and `node_modules/.bin/tsc` is whichever one npm
|
||||
linked last. `check:admin` stays on TypeScript 6: `--tsgo` cannot follow
|
||||
`.svelte` imports from outside its tsconfig's folder (`web/admin` imports
|
||||
`../src/lib/ui`), and a component it cannot map falls back to the ambient
|
||||
`*.svelte` shim - unchecked props, and no error. Dependabot ignores
|
||||
`typescript` majors and the alias (it mishandles `npm:` aliases): bump the
|
||||
two by hand. `~7.0` because 7.1 changes the API svelte-check's experimental
|
||||
mode uses. TypeScript 6 goes when svelte-check accepts 7 alone:
|
||||
`docs/plan/17-typescript-7.1.md` lists the conditions, the steps and the
|
||||
planted-error check that proves the switch.
|
||||
- **Real paths everywhere, including the packaged apps.** There is no
|
||||
HashRouter and no hash shim: `tauri::manager::get_asset()` falls back through
|
||||
`<path>.html`, `<path>/index.html`, then `index.html`, so the Tauri webview
|
||||
@@ -508,7 +875,11 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
HashRouter-era `/#/…` URLs still arrive - from released 1.4.x builds, and from
|
||||
old links to the GitHub Pages site, whose tombstone redirect forwards the
|
||||
fragment - and `upgradeLegacyHashUrl()` upgrades them on load with
|
||||
`goto(…, {replaceState})`. Do not remove it, and do not reduce it to a
|
||||
`goto(…, {replace: true})`; a path that matches no route (kit 3's `goto`
|
||||
rejects it) goes to `/error/404`. The hash is resolved against the page's
|
||||
origin and ignored if it names another (`#//other.example`), and nothing
|
||||
from it may reach `location.*` - CodeQL flagged exactly that as XSS and an
|
||||
open redirect. Do not remove it, and do not reduce it to a
|
||||
`history.replaceState`: that fixed the address bar and left the dashboard
|
||||
rendered.
|
||||
- **`web/static/_headers` sets the browser cache, by path.** Hashed output
|
||||
@@ -531,7 +902,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
must still trigger a build, or the site keeps the old text and hash; see
|
||||
`docs/DEPLOYMENT.md` "Which commits deploy" for a configuration that does
|
||||
both. Excludes beat includes there.
|
||||
- **The CSP lives in `web/svelte.config.js` (`kit.csp`), not in `_headers`.**
|
||||
- **The CSP lives in `web/build/sveltekit-config.ts` (`csp`), not in `_headers`.**
|
||||
SvelteKit emits one inline bootstrap script per page and hashes it there. A
|
||||
header CSP cannot coexist: browsers enforce the INTERSECTION of header and
|
||||
meta policies, so a `script-src 'self'` header blocks the script whatever the
|
||||
@@ -541,7 +912,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
- **That CSP has TWO flavours, chosen by `TAURI_ENV_PLATFORM`.** Under Tauri
|
||||
the page origin is `tauri://localhost`, so `'self'` means the BUNDLE, not the
|
||||
site — a `connect-src 'self'` policy blocks every `/api/data/*` fetch and the
|
||||
packaged apps show an empty catalogue. `svelte.config.js` adds
|
||||
packaged apps show an empty catalogue. `sveltekitConfig(true)` adds
|
||||
`https://free-steam-games.win`, `https://api.github.com`, `ipc:` and
|
||||
`http://ipc.localhost` only for that build; the web policy stays `'self'`,
|
||||
because dropping `api.github.com` from it was deliberate (`/api/activity`
|
||||
@@ -560,7 +931,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
the Tauri build with any of them.
|
||||
- **Cloudflare Web Analytics must stay on "JS Snippet installation", never
|
||||
automatic.** Automatic injection adds an INLINE loader at the edge, after our
|
||||
response; `kit.csp` is `mode: "hash"`, and CSP3 makes a `script-src` carrying
|
||||
response; the CSP is `mode: "hash"`, and CSP3 makes a `script-src` carrying
|
||||
a hash ignore `'unsafe-inline'` — so no policy can ever admit it. It was
|
||||
enabled that way for months, logging two CSP violations per page load and
|
||||
collecting nothing. `lib/analytics.ts` appends the beacon itself, from the
|
||||
@@ -601,7 +972,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
- **Never put `use:`, `onload` or `onerror` on an `<img>` that can be
|
||||
prerendered.** Svelte then writes `onload="this.__e=event"` and
|
||||
`onerror="this.__e=event"` into the HTML, to replay an event that fired
|
||||
before hydration, and `kit.csp` is a hash policy, which refuses inline event
|
||||
before hydration, and the CSP is a hash policy, which refuses inline event
|
||||
handlers: one CSP violation per page view (the game hero logged it on every
|
||||
page until it moved to an attachment). Use `{@attach}`, which writes nothing;
|
||||
`lib/img-fallback.ts` recovers a load that already failed from
|
||||
@@ -676,7 +1047,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
`lib/fallback-route.ts` recovers the route offline the same way it does
|
||||
online. `verify-dist.mjs` now parses `dist/sw.js` and fails if the bound URL
|
||||
is not a precache entry.
|
||||
- **`kit.paths.relative` must stay `false`.** SvelteKit defaults it to `true`,
|
||||
- **`paths.relative` must stay `false`.** SvelteKit defaults it to `true`,
|
||||
which gives every PRERENDERED page `./_app/...` asset URLs. Served as the
|
||||
fallback for `/games/730` those resolve to `/games/_app/...`, which misses,
|
||||
falls into the SPA handler, and comes back as `index.html` with
|
||||
@@ -700,8 +1071,9 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
`fallback-route.test.ts` holds the list against the routes whose `prerender`
|
||||
is not literally `true`, and checks each one marks itself. A path that matches NO route hydrates the same
|
||||
way with `page.route.id === null`; the root layout renders the 404 view in
|
||||
place. Never `goto()` an unmatched URL — SvelteKit falls back to a native
|
||||
load, the host answers with `index.html` again, and it loops forever.
|
||||
place. Never `goto()` an unmatched URL: SvelteKit 3 rejects it (SvelteKit 2
|
||||
fell back to a native load, the host answered with `index.html` again, and
|
||||
it looped forever).
|
||||
- **Game pages are prerendered from build-time seeds, through a UNIVERSAL load.**
|
||||
`build/game-seeds.ts` serves `virtual:game-seeds`: in the SSR build it reads
|
||||
`../data` and inlines a seed per game (slow-changing fields only — never
|
||||
@@ -710,7 +1082,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
Do not turn it into `+page.server.ts`: client navigation would then fetch
|
||||
`__data.json`, which for a game added after the deploy is `index.html` at
|
||||
200, and the page errors. `__PRERENDER_GAMES__` is false for Tauri.
|
||||
`kit.prerender.handleHttpError` ignores 404s under `/img/` and `/api/` only,
|
||||
`prerender.handleHttpError` ignores 404s under `/img/` and `/api/` only,
|
||||
because the crawler follows the page's `<img>` into a Worker route that does
|
||||
not exist at build time. That handler only decides pass/fail; the
|
||||
`[404] GET /img/…` line per game came from SvelteKit's DEFAULT server
|
||||
@@ -737,7 +1109,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
`page.url.origin`, which during prerender is SvelteKit's internal
|
||||
`http://sveltekit-prerender` host. `seo.test.ts` enforces both.
|
||||
- **`sitemap.xml` is a prerendered route**, not a static file, driven by
|
||||
`import.meta.glob` over the route table. It needs `kit.prerender.entries`
|
||||
`import.meta.glob` over the route table. It needs `prerender.entries`
|
||||
because nothing links to it. Extra exports from a `+server.ts` must be
|
||||
`_`-prefixed or SvelteKit rejects the build.
|
||||
- **`static/` art is generated.** `icon.svg` is the only hand-edited mark;
|
||||
@@ -746,7 +1118,7 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
SVG.
|
||||
- **The web app registers its service worker itself, after consent and the
|
||||
human check.**
|
||||
`@vite-pwa/sveltekit` cannot inject a registration script — SvelteKit has no
|
||||
vite-plugin-pwa cannot inject a registration script — SvelteKit has no
|
||||
`index.html` for it to write into — so for the whole of 2.0.0 the worker was
|
||||
built and never registered, and the manifest was linked from no page.
|
||||
`lib/pwa-state.svelte.ts` calls `registerSW` (`registerType: "prompt"`, so a
|
||||
@@ -778,6 +1150,15 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
"no update" — for anything unusable. Like `/api/activity` it is public and
|
||||
must never use the GitHub App token. A desktop release is offered only once
|
||||
its draft is published.
|
||||
tauri-action v1 writes API asset URLs (`api.github.com/repos/…/releases/assets/<id>`)
|
||||
into `latest.json`, which that check refuses, and has no setting to change
|
||||
it: the `updater-json` job of `release-desktop.yml` (`scripts/updater_json.py`)
|
||||
rewrites them to the release's download URLs once every platform is built,
|
||||
refusing any entry whose signature is not its file's `.sig`. Without it a
|
||||
desktop release is offered to nobody (desktop-v2.2.1, the first v1 build,
|
||||
needed a hand fix). Between the tag push and publishing the feed answers 204
|
||||
anyway: the new tag is already in `releases.atom`, its `latest.json` not yet
|
||||
public.
|
||||
- **Legal consent is per-document content hashes, not one integer.**
|
||||
`build/legal-versions.ts` serves `virtual:legal-versions` (a hash per
|
||||
document, inlined) and `virtual:legal-sources` (the raw markdown, imported
|
||||
@@ -797,24 +1178,129 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
The gate renders only after `consent.hydrated`: rendered before storage was
|
||||
read, it was baked into every prerendered page and flashed for returning
|
||||
visitors.
|
||||
- **Declining or leaving at the gate.** In the apps Decline calls `exit()` from
|
||||
`@tauri-apps/api/app` (capability `core:app:allow-exit` in
|
||||
`capabilities/default.json`), never `getCurrentWindow().close()`: on Android
|
||||
that resolves without closing anything (tao reports a destroyed window only
|
||||
from the Activity's `onDestroy`), so Decline did nothing there before 2.5.0.
|
||||
`exit()` finishes the activity on Android and ends the process on the
|
||||
desktop; the declined notice appears if the app is still alive 2 s later. On
|
||||
the web, "Leave site" (`lib/leave-site.ts`, hidden under Tauri) goes back to
|
||||
the page before the site, because no page may open the browser's own start
|
||||
page (`chrome://newtab`, `about:home`). Rules:
|
||||
- It steps over ALL of the site's entries at once,
|
||||
`history.go(-(navigation.currentEntry.index + 1))`: `entries()` is the
|
||||
contiguous same-origin run, other documents and SvelteKit's pushState
|
||||
entries included. Without the Navigation API it is one step back.
|
||||
- `history.go()` is silent when there is nowhere to go (the foreign entries
|
||||
can all be forward ones), so a 1.5 s watchdog shows "Nothing to go back
|
||||
to"; `beforeunload`, `pagehide` and `popstate` cancel it. `pagehide`
|
||||
matters: timers freeze in the back/forward cache and resume on restore.
|
||||
- When every entry is the site's, closing the tab is a SECOND, explicit click
|
||||
(`closeTab()`): closing the last tab closes the browser window with it.
|
||||
- `consent-gate.test.ts` holds the exit import, the capability and the two
|
||||
guarded Leave buttons; `leave-site.test.ts` holds the algorithm.
|
||||
- **`/welcome` is shown once, by the layout, and only to a visit that STARTED
|
||||
on `/`** (not a deep link, not `/#/…`, not mid-session), after consent and
|
||||
the human check. It
|
||||
uses `replaceState`, and the page marks itself seen on mount, so Back cannot
|
||||
loop into it. Crawlers never consent, so `/` stays the indexable page.
|
||||
- **`/legal/[doc=legaldoc]` has a param matcher** (`src/params/legaldoc.ts`).
|
||||
- **`/legal/[doc=legaldoc]` has a param matcher** (`legaldoc` in `src/params.ts`).
|
||||
An unknown slug therefore matches NO route and gets the layout's translated
|
||||
404; without it the host's fallback (the prerendered dashboard) hydrated as
|
||||
the doc route. Legal labels and hints in `lib/legal.ts` are i18n keys.
|
||||
- **`/games` mirrors its filters into the query string, browser-only**:
|
||||
`onMount` reads `location.search` (a link with filter parameters replaces the
|
||||
stored filters) and a debounced `replaceState` writes back. Never read
|
||||
stored filters) and a debounced shallow `goto` writes back. Never read
|
||||
`url.search` in markup or a load - prerender throws on it. The page number
|
||||
lives in the filter store, keyed to the criteria (`filters.pageFor`), so Back
|
||||
from a game keeps the page and a changed filter starts again at page 1.
|
||||
The language filter (`?lang=`) offers the names stored in `languages`,
|
||||
Steam's English ones: data, never i18n keys.
|
||||
- **`/random` keeps its picks in memory, and only the reader rolls.**
|
||||
`lib/random.svelte.ts` holds appids, module-level so Back from a game shows
|
||||
the same games, and NO `f2p:*` key: the Privacy Policy lists every stored
|
||||
key, and editing it reopens the consent gate for everyone. Rules:
|
||||
- A roll happens in a handler, or once in an `untrack`ed effect when the
|
||||
catalogue first arrives - never in `$derived` or markup, which would roll
|
||||
again on every revalidation or language switch. `resolve()` is the
|
||||
deterministic part: it drops a pick that left the catalogue or stopped
|
||||
qualifying, and nothing tops it back up.
|
||||
- Randomness is `crypto.getRandomValues` with rejection sampling and a sparse
|
||||
Fisher-Yates (`lib/random-pick.ts`). Never `Math.random`: SonarCloud
|
||||
reports it as hotspot S2245, and an unreviewed hotspot fails the gate.
|
||||
- Never a game marked unsafe or without an appid; dead games only on
|
||||
request. The route is top-level on purpose: under `/games/` the header
|
||||
search would stop jumping to /games, `isActive` would light Games too, and
|
||||
the PWA's `globIgnores` would leave it out of the precache.
|
||||
- A plural key needs its base key (`random.pool` beside `random.pool_one`):
|
||||
`t()` falls back from `_other` to the base, and the i18n test requires
|
||||
every literal key to exist.
|
||||
- **Search folds; storage never does.** `lib/search-fold.ts` `fold()` is NFKC
|
||||
plus hiragana to katakana, applied to BOTH sides of every search box
|
||||
(`/games`' Fuse index, the palette, /developers, /publishers, the anti-cheat
|
||||
list), so `トロイ`, `とろい` and `トロイ` find one game and a full-width `4`
|
||||
or `:` its ASCII twin. Never apply it to stored text: NFKC rewrites U+3000
|
||||
and half-width kana, which `save_main()` keeps as spelling. Rules:
|
||||
- Fuse gets one `getFn` per KEY. A wrapped `Fuse.config.getFn` hands back
|
||||
`{v, i}` objects for array fields (`tags`, `developer`, `publisher`), not
|
||||
strings, and folding those type-checks and then breaks.
|
||||
- Fold the query, THEN trim: NFKC turns U+3000 into a plain space.
|
||||
- Not Fuse's `ignoreDiacritics`: it strips the dakuten, making ガ equal カ.
|
||||
And no `includeMatches`: its positions would point into folded text.
|
||||
- The header search jumps to /games only once an input method has finished
|
||||
composing (`lib/layout/header-search.ts`); the value is still written on
|
||||
every keystroke, because Android keyboards compose Latin words too. The
|
||||
jump is `goto("/games", {reset: false})`: the default reset moved focus to
|
||||
`<body>` and the next keystroke was lost. The page scrolls inside `<main>`,
|
||||
which no reset touches, so focus is all `reset` changes there.
|
||||
- The palette takes one kanji, kana or Hangul syllable where Latin needs two.
|
||||
- A CSV download starts with a byte order mark (`csvForExcel()`), or Excel
|
||||
opens CJK names as mojibake. It is the escape `"\uFEFF"` in the source;
|
||||
the editing tools turn a typed escape into the raw character, so write it
|
||||
with a script and check the bytes.
|
||||
- **`safe` is classified by `lib/safety.ts`** (`y`, `n`, `?` = not reviewed,
|
||||
`""` = never set). `/games`, `/stats` and `/health` all use it; `?` is a
|
||||
to-do, not missing data, so /health reports it as its own group.
|
||||
- **`ACCESSIBILITY.md` (root) is a claim about this code, like this file.**
|
||||
Its "What works today" and "Known limitations" lists were checked against
|
||||
the code on 2026-11-09. A change that fixes a limitation, or adds one,
|
||||
edits the list and its "Last reviewed" line in the same pull request.
|
||||
Reports arrive through `.github/ISSUE_TEMPLATE/accessibility.yml` (label
|
||||
`accessibility`), and the About page links both the form and the statement.
|
||||
`src/lib/a11y.test.ts` holds the fixes it lists. Rules that are easy to
|
||||
break:
|
||||
- **The games table is an ARIA table only when it is complete.** That means
|
||||
`role="table"` with `aria-rowcount`/`aria-colcount`, a `rowgroup`, and
|
||||
`aria-rowindex` on every virtualised row. Every column needs a label or an
|
||||
`srLabel` (`games/columns.ts`). It used to be `<a role="row">` with
|
||||
nothing around it, which a screen reader read as neither a table nor a
|
||||
link.
|
||||
- **A row is not a link.** The name's `<a>` stretches over the row
|
||||
(`after:absolute after:inset-0`). Anything that must stay hoverable or
|
||||
clickable on its own sits above it with `relative z-[1]`: the tooltips,
|
||||
and the Steam `<a>`, which is `tabindex="-1"` so a row is one Tab stop.
|
||||
The row draws the focus ring (`has-[:focus-visible]`), because cells clip
|
||||
overflow.
|
||||
- **The first-run overlays report to `lib/overlays.svelte.ts`.** The layout
|
||||
makes the page behind them `inert`: the bare pages' wrapper, the skip link
|
||||
and the shell. Ctrl/Cmd+K stands down while they are open, because the
|
||||
palette would open under the gate and trap focus there. They are
|
||||
`role="dialog"`, focus themselves with `focusOnMount`, and title
|
||||
themselves with an h2. `BackToTop` is inside the shell so that it goes
|
||||
inert with the page.
|
||||
- **Kernel-level anti-cheat goes through `games/AntiCheatBadge.svelte`.** It
|
||||
adds a shield icon and the words, so the colour is not the only cue.
|
||||
- **Theme colours are checked by the WCAG formula.** The test computes
|
||||
4.5:1 for text (badges on their /15 tint included) and 3:1 for
|
||||
`--input`/`--ring` in both themes. A token edit that drops below either
|
||||
fails.
|
||||
- **Desktop zoom needs both parts:** `zoomHotkeysEnabled` on the window,
|
||||
and `capabilities/zoom.json`. The latter is desktop-only, and macOS/Linux
|
||||
zoom through an injected script that calls `set_webview_zoom`.
|
||||
|
||||
Svelte's a11y warnings never fail CI (`svelte-check` runs without
|
||||
`--fail-on-warnings`), so read them.
|
||||
|
||||
## Admin SPA (`web/admin/`)
|
||||
|
||||
@@ -838,8 +1324,9 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
first: `worker/index.ts` imports the generated module, so a bare
|
||||
`wrangler deploy` or `tsc` without it fails. That failure is intended.
|
||||
`build:admin` runs `svelte-kit sync` first: the admin imports files under
|
||||
`web/src`, whose `tsconfig.json` extends `.svelte-kit/tsconfig.json`, and on a
|
||||
clean checkout (CI) that file does not exist until SvelteKit has synced. The
|
||||
`web/src`, whose `tsconfig.json` extends `$app/tsconfig`
|
||||
(`node_modules/$app/tsconfig.json`), and on a clean checkout (CI) that file
|
||||
does not exist until SvelteKit has synced. The
|
||||
emitter reads the bundle in `writeBundle`, never the output directory in
|
||||
`closeBundle`, which also runs after a FAILED build and hid that error behind
|
||||
an ENOENT.
|
||||
@@ -861,7 +1348,8 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
|
||||
- **It may import only pure modules of the public app**: `src/lib/ui/*`,
|
||||
`src/lib/utils.ts`, `src/lib/prefs.svelte.ts`, `src/fonts.css`,
|
||||
`src/styles/theme.css` (the design tokens, shared by both builds). Never
|
||||
`$app/*` or `$lib/*`; that build cannot resolve them.
|
||||
`$app/*` (nor a module that imports it) and no virtual module; that build
|
||||
cannot resolve them.
|
||||
- **`admin/mock/` is a dev server, not a mode.** `npm run dev:admin` runs the
|
||||
real handlers against an in-memory D1 and fake GitHub; nothing under `worker/`
|
||||
or `admin/src` may import it, and the Worker has no flag that skips
|
||||
|
||||
+2
-2
@@ -8,12 +8,12 @@ Be nice. Or at least civil. We're all unemployed introverts at heart (or pretend
|
||||
### Standards
|
||||
- **Be respectful:** No harassment, no toxicity, no personal attacks. This ain't Dota 2 chat.
|
||||
- **Be helpful:** Suggestions, additions, fixes – yes. Trolling, spam, off-topic rants – no.
|
||||
- **Be inclusive:** Everyone's welcome, regardless of skill level (especially noobs on Easy mode).
|
||||
- **Be inclusive:** Everyone's welcome, regardless of skill level (especially noobs on Easy mode), and however you use the site: mouse, keyboard, screen reader, zoom. If something keeps you out, see [`ACCESSIBILITY.md`](ACCESSIBILITY.md).
|
||||
- **No malware/fake links:** Instant ban from contributing. I have trust issues already.
|
||||
- **Disagreements?** Keep it calm in Issues/PRs. If it gets heated, I'll just close it and go play a game.
|
||||
|
||||
### Enforcement
|
||||
I'm the only maintainer (with Grok as backup), so violations = close issue/PR, block if needed. No appeals – life's too short.
|
||||
I'm the only maintainer (with an AI assistant as backup), so violations = close issue/PR, block if needed. No appeals – life's too short.
|
||||
|
||||
**Reporting:** if something needs raising privately rather than in the Issue
|
||||
thread it happened in, email **contact@poli0981.dev**. One person reads it, so
|
||||
|
||||
+73
-31
@@ -2,7 +2,28 @@
|
||||
|
||||
Yo, thanks for stopping by! This repo is a hobby project by a broke, unemployed Vietnamese dev (20-something, introvert max level, dropped out uni year 3, mooching off family, Steam library 400+ games 80% under $10 sale addiction). Powered ~70% by AI assistants — Grok for v1, Claude for v2+ — the only non-judgmental friends keeping this alive while I play Easy mode only :))
|
||||
|
||||
Want to help? Awesome — no strict rules, life's hard enough. Pick whichever path below is least-friction for you.
|
||||
Want to help? Awesome — life's hard enough, so the rules are short.
|
||||
|
||||
## Project status: stable, maintenance only
|
||||
|
||||
Since 2026-11-11 the project is finished rather than abandoned. The pipeline
|
||||
still refreshes the list every day and the site and apps stay up, but the code
|
||||
is no longer growing:
|
||||
|
||||
- **No new features.** Feature requests are not taken, as issues, discussions
|
||||
or pull requests. A pull request that adds one is closed, however good it is.
|
||||
- **Code changes only for** security advisories (CVEs), runtime and dependency
|
||||
updates (Node, Python, Rust, the npm / pip / cargo packages, the GitHub
|
||||
Actions), and whatever those break. Dependabot opens most of them.
|
||||
- **Issues and pull requests are for the data:** adding a game, correcting one,
|
||||
removing one.
|
||||
- Something **broken** (the site, an app, a wrong number) or an
|
||||
**accessibility barrier** can still be reported. It gets a fix, not a
|
||||
redesign.
|
||||
- A **vulnerability** goes through [`SECURITY.md`](SECURITY.md), never a public
|
||||
issue.
|
||||
|
||||
Forks are welcome to go further: the code is MIT and the dataset CC BY 4.0.
|
||||
|
||||
## Maintainer contact
|
||||
|
||||
@@ -27,50 +48,71 @@ reporting, see [`SECURITY.md`](SECURITY.md)), and <https://poli0981.dev/> or
|
||||
|
||||
## How to contribute
|
||||
|
||||
### 1. Open an issue (bugs, requests, removals)
|
||||
### 1. Open an issue
|
||||
|
||||
Go to the [Issues tab](https://github.com/poli0981/free-steam-games-list/issues/new/choose) and pick a template:
|
||||
Go to the [Issues tab](https://github.com/poli0981/free-steam-games-list/issues/new/choose) and pick a form:
|
||||
|
||||
- ➖ **Delete game** (max 10 per issue)
|
||||
- 🐛 **Bug report**
|
||||
- 💡 **Feature request / improvement**
|
||||
- 📢 **Feedback / rant**
|
||||
- ❓ **Off-topic**
|
||||
- ➕ **Add game** — a free game that is still missing (max 10 per issue)
|
||||
- ✏️ **Edit game** — a published game with something wrong: genre, type, anti-cheat, notes, safe
|
||||
- ➖ **Delete game** — paid now, not a game, malware, duplicate (max 10 per issue)
|
||||
- 🐛 **Bug report** — something that is broken
|
||||
- ♿ **Accessibility barrier** — something you can't use with a keyboard, a screen reader or zoom (see [`ACCESSIBILITY.md`](ACCESSIBILITY.md))
|
||||
|
||||
Fill the form (checkboxes, dropdowns, short descriptions). Every template is reviewed by hand when caffeine hits — none of them auto-run a workflow.
|
||||
Blank issues are off. Every form is reviewed by hand when caffeine hits — none of them auto-run a workflow.
|
||||
|
||||
> Issues are for **reports**, not game submissions. To suggest a game, see section 2.
|
||||
New free games are found on Steam automatically every day and reviewed before they are listed, so most turn up on their own. Use **Add game** for one that is still missing a few days after it went free.
|
||||
|
||||
### 2. Open a pull request (data)
|
||||
|
||||
### 2. Suggest a game, or a correction
|
||||
Fork → branch → one of these → push → open the PR. The template has a short checklist.
|
||||
|
||||
New free games are found on Steam automatically every day and reviewed before they are listed, so most turn up on their own. If one is still missing a few days after it went free, or a published game has something wrong (genre, anti-cheat, notes…), post it in [Discussions › Ideas](https://github.com/poli0981/free-steam-games-list/discussions/categories/ideas) with the store link. A correction becomes an override that every pipeline run keeps.
|
||||
**Add a game:** append store links to `scripts/temp_info.jsonl`.
|
||||
|
||||
```jsonl
|
||||
{"link": "730"}
|
||||
{"link": "https://store.steampowered.com/app/570/"}
|
||||
```
|
||||
|
||||
A queued line is a link and nothing else (full URL, short URL or bare appid): any other key is ignored, and the game is fetched from Steam and checked (free, a game, reachable) before it is published.
|
||||
|
||||
**Correct a game:** add an override. It is a standing instruction in `data/overrides/<appid>.json` that every pipeline run keeps.
|
||||
|
||||
```bash
|
||||
python scripts/edit_game.py 730 --show
|
||||
python scripts/edit_game.py 730 --set genre="FPS" --reason "Steam's genre is too coarse"
|
||||
```
|
||||
|
||||
Only the human-judged fields can be overridden: `genre`, `type_game`, `safe`, `notes`, `anti_cheat`, `anti_cheat_note`, `is_kernel_ac`. Everything else (name, tags, languages, reviews, players…) is whatever Steam says and is refreshed from Steam.
|
||||
|
||||
**Remove a game:** add a blocklist line. The reason and the note are public.
|
||||
|
||||
```bash
|
||||
python scripts/delete_game.py 730 --reason not_free --note "paid since 2026-11"
|
||||
```
|
||||
|
||||
Reasons: `not_free`, `not_a_game`, `duplicate`, `broken`, `inappropriate`, `other`.
|
||||
|
||||
Leave out `--apply` in both commands, and **never edit `data/data_*.jsonl` or `data/index.json` by hand**: the pipeline rewrites them on its next run and an edit there is lost (and breaks the hashes the apps check). `Check Overrides` validates an override or blocklist change on the pull request.
|
||||
|
||||
### 3. Pull requests that touch code
|
||||
|
||||
Only two kinds are merged now:
|
||||
|
||||
- a **security fix** — report it privately first ([`SECURITY.md`](SECURITY.md));
|
||||
- a **runtime or dependency update**, or the repair of what one broke.
|
||||
|
||||
`npm run typecheck && npm test && npm run build && node scripts/verify-dist.mjs --web` must pass in `web/`, and `python -m pytest scripts/tests` for the pipeline. Dependencies are pinned and hashed; the rules are in [`CLAUDE.md`](CLAUDE.md) ("CI installs only what is pinned").
|
||||
|
||||
The companion browser extension ([steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension)) is archived and no longer a way in.
|
||||
|
||||
### 3. Manual: fork + commit (most invasive)
|
||||
|
||||
For code changes, or to queue games yourself:
|
||||
|
||||
1. Fork → branch.
|
||||
2. Edit code in `scripts/` / `web/src/` / docs, or append store links to `scripts/temp_info.jsonl`:
|
||||
```jsonl
|
||||
{"link": "730"}
|
||||
{"link": "https://store.steampowered.com/app/570/"}
|
||||
```
|
||||
3. Push → open PR. Reviewer (= me) will look when caffeine hits.
|
||||
|
||||
A queued line is a link and nothing else: any other key is ignored, and the game is fetched from Steam and checked (free, a game, reachable) before it is published.
|
||||
|
||||
---
|
||||
|
||||
## Tips for smooth contributions
|
||||
|
||||
- **Games must be free-to-play on Steam.** No demos, no paid-now games, no malware-flagged ones.
|
||||
- **Notes / safe** are worth mentioning in a suggestion ("safe to play", "Toxic max", "Grind phê Easy mode"); the maintainer records them as overrides.
|
||||
- **Spam / off-topic** issues get closed without comment. Don't be that person.
|
||||
- **Code style:** match the surrounding file. No hard rules. The Python pipeline is intentionally low-ceremony; the web side (SvelteKit, the Worker, `admin/`) is TS-strict.
|
||||
- **Tests:** for web changes, `npm run typecheck && npm test && npm run build` must pass (in `web/`). For pipeline changes, `python -m pytest scripts/tests`.
|
||||
- **Notes / safe** are worth mentioning in an Add or Edit request ("safe to play", "Toxic max", "Grind phê Easy mode"); the maintainer records them as overrides.
|
||||
- **Spam / off-topic / feature-request** issues get closed without comment. Don't be that person.
|
||||
- **Questions and chit-chat** go to [Discussions](https://github.com/poli0981/free-steam-games-list/discussions), not issues.
|
||||
|
||||
## Code of conduct
|
||||
|
||||
@@ -80,4 +122,4 @@ A queued line is a link and nothing else: any other key is ignored, and the game
|
||||
|
||||
Thanks for making this noob repo better! Star if you find a hidden gem, or buy me a coffee via [FUNDING.yml](.github/FUNDING.yml) to fuel instant noodles + more sale games ✨
|
||||
|
||||
Questions? Open an issue — that's contributing too :))
|
||||
Questions? [Discussions](https://github.com/poli0981/free-steam-games-list/discussions) — that's contributing too :))
|
||||
@@ -1,15 +1,32 @@
|
||||
[](data/)
|
||||
[](#project-status)
|
||||
[](data/)
|
||||
[](.github/workflows)
|
||||
[](games/top-online.md)
|
||||
[](https://github.com/poli0981/free-steam-games-list)
|
||||
[](https://free-steam-games.win/)
|
||||
[](https://github.com/poli0981/free-steam-games-list/releases)
|
||||
[](https://github.com/poli0981/free-steam-games-list/releases)
|
||||
[](.github/workflows/purge-unhealthy.yml)
|
||||
[](.github/workflows/purge-unhealthy.yml)
|
||||
|
||||
[](https://github.com/poli0981/free-steam-games-list/releases)
|
||||
[](https://github.com/poli0981/free-steam-games-list/releases)
|
||||
[](https://github.com/poli0981/free-steam-games-list/releases)
|
||||
[](https://free-steam-games.win/)
|
||||
|
||||
[](https://github.com/poli0981/free-steam-games-list/actions/workflows/web-ci.yml)
|
||||
[](https://github.com/poli0981/free-steam-games-list/actions/workflows/python-tests.yml)
|
||||
[](https://github.com/poli0981/free-steam-games-list/actions/workflows/codeql.yml)
|
||||
[](https://github.com/poli0981/free-steam-games-list/actions/workflows/qodana.yml)
|
||||
[](https://sonarcloud.io/summary/new_code?id=poli0981_free-steam-games-list)
|
||||
[](https://sonarcloud.io/summary/new_code?id=poli0981_free-steam-games-list)
|
||||
[](.github/dependabot.yml)
|
||||
|
||||
[](LICENSE)
|
||||
[](LICENSE-DATA)
|
||||
[](web/.node-version)
|
||||
[](requirements.txt)
|
||||
[](web/README.md)
|
||||
[](web/src-tauri/TAURI.md)
|
||||

|
||||
[](.github/FUNDING.yml)
|
||||
|
||||
A **curated list** of free-to-play games on Steam — now ~3,600 of them — no quality guarantees, no endorsements, just pure listings by a broke, unemployed Vietnamese dev with too much free time and a Steam library full of sale games (80% under $10).
|
||||
A **curated list** of free-to-play games on Steam — the badge above has today's count — no quality guarantees, no endorsements, just pure listings by a broke, unemployed Vietnamese dev with too much free time and a Steam library full of sale games (80% under $10).
|
||||
|
||||
**v4.0.0** is the version that got rebuilt from the ground up. It is still a list. It is also:
|
||||
|
||||
@@ -23,35 +40,54 @@ A **curated list** of free-to-play games on Steam — now ~3,600 of them — no
|
||||
|
||||
**Wallet safe (for now). Play at your own risk.**
|
||||
|
||||
### Project status
|
||||
|
||||
> [!NOTE]
|
||||
> **Stable, maintenance only (since 2026-11-11).** The project does what it set
|
||||
> out to do, so it is finished rather than abandoned: the pipeline keeps the
|
||||
> list fresh every day, and the site and apps stay up.
|
||||
>
|
||||
> - **No new features.** Feature requests are not taken, as issues or as pull requests.
|
||||
> - **Code changes only for** security advisories (CVEs), runtime and dependency
|
||||
> updates, and whatever those break.
|
||||
> - **Issues and pull requests are for the data:** adding a game, correcting
|
||||
> one, removing one. Something broken or an accessibility barrier can still be
|
||||
> reported; it gets a fix, not a redesign.
|
||||
> - A vulnerability goes through [`SECURITY.md`](SECURITY.md), never a public issue.
|
||||
>
|
||||
> Details in [`CONTRIBUTING.md`](CONTRIBUTING.md).
|
||||
|
||||
### Quick links
|
||||
|
||||
| Surface | URL |
|
||||
| -------------------- | -------------------------------------------------------------------------------------------------------------------- |
|
||||
| 🌐 Web app | <https://free-steam-games.win/> |
|
||||
| 🖥️ Desktop releases | [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases) (Win `.msi`, Mac `.dmg`, Linux `.AppImage`) |
|
||||
| 🖥️ Desktop releases | [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases) (Win `.msi` / `.exe`, Mac `.dmg`, Linux `.AppImage` / `.deb` / `.rpm`) |
|
||||
| 📱 Android APK | [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases) (sideload `.apk`, **Android 11+** — see [`docs/android-support.md`](docs/android-support.md)) |
|
||||
| 🏆 Top online (md) | [games/top-online.md](games/top-online.md) |
|
||||
| 🎯 Top offline (md) | [games/top-offline.md](games/top-offline.md) |
|
||||
| 📦 Raw data | [data/data_001.jsonl](data/data_001.jsonl) … `data_005.jsonl` (5 sharded JSONL files) |
|
||||
| 📦 Raw data | [data/](data/) — JSONL shards of 800 games each (`data_001.jsonl` …), listed with a SHA-256 each in [`data/index.json`](data/index.json) |
|
||||
| 🛠️ About | <https://free-steam-games.win/about> (in-app) |
|
||||
| 👤 Authors | [`AUTHORS.md`](AUTHORS.md) — maintainer + contact channels + AI-assistant disclosure |
|
||||
| ♿ Accessibility | [`ACCESSIBILITY.md`](ACCESSIBILITY.md) — what works with a keyboard, screen reader and zoom, what doesn't yet, how to report a barrier |
|
||||
|
||||
### What's new in v4.0.0
|
||||
### What's in v4
|
||||
|
||||
<details>
|
||||
<summary><b>Web app at <code>free-steam-games.win/</code></b></summary>
|
||||
|
||||
A SvelteKit 2 / Svelte 5 app, prerendered and served by a Cloudflare Worker that also proxies the dataset (`/api/data/*`) and Steam artwork (`/img/*`), so your browser talks to this site only — apart from Cloudflare's analytics beacon and its Turnstile human check, both loaded only after you accept the terms. Features:
|
||||
A SvelteKit 3 / Svelte 5 app, prerendered and served by a Cloudflare Worker that also proxies the dataset (`/api/data/*`) and Steam artwork (`/img/*`; on the website the art comes from the site's own media host, `media.free-steam-games.win`), so your browser talks to this site only — apart from Cloudflare's analytics beacon and its Turnstile human check, both loaded only after you accept the terms. Features:
|
||||
|
||||
- **Browse** — virtualised table (TanStack Virtual), filters for genre, type, platform, status, anti-cheat and safety, Fuse.js fuzzy search, sortable columns, 50/100/200/500/all pages. Filters live in the URL, so a filtered view can be shared.
|
||||
- **Charts** — Apache ECharts: dashboard KPIs, genres, platforms, languages, tags, anti-cheat (chart and a searchable index), reviews, player tiers, release years and catalogue growth, DRM/DLC, delisted games, plus a stats page (Metacritic, retention, games that went quiet).
|
||||
- **A page per game** — `/games/:appid` is prerendered for search engines and filled with live player counts and reviews in the browser.
|
||||
- **Random games** — `/random` rolls one to five games when you cannot decide: online, offline or either, dead games only if you ask, never one marked unsafe. Roll again for a new set; opening a game and coming back keeps the picks.
|
||||
- **Fresh data, verified** — `data/index.json` carries a SHA-256 per shard; the app only caches a generation it could verify, keeps the last good one offline, and re-checks when you come back to the tab.
|
||||
- **Installable** — a web app you can install, with an offline mode and an update prompt.
|
||||
- **i18n** vi / en — auto-detected, switchable from the welcome page or Settings.
|
||||
- **⌘K command palette**, **first-run introduction**, and the legal documents rendered in the app.
|
||||
|
||||
Pushing to `main` deploys (Cloudflare Workers Builds). Pipeline commits to `data/**` do not need a rebuild: the data is proxied, not bundled. See [`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md).
|
||||
Cloudflare Workers Builds deploys from `main`; which commits trigger a build is in [`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md). Pipeline commits to `data/**` do not need a rebuild: the data is proxied, not bundled.
|
||||
|
||||
</details>
|
||||
|
||||
@@ -60,7 +96,7 @@ Pushing to `main` deploys (Cloudflare Workers Builds). Pipeline commits to `data
|
||||
|
||||
A native shell around the same web app, distributed via [GitHub Releases](https://github.com/poli0981/free-steam-games-list/releases):
|
||||
|
||||
- Windows `.msi`, macOS `.dmg` (universal Apple Silicon + Intel), Linux `.AppImage` and `.deb`, and an Android `.apk`.
|
||||
- Windows `.msi` and `-setup.exe`, macOS `.dmg` (universal Apple Silicon + Intel), Linux `.AppImage`, `.deb` and `.rpm`, and an Android `.apk`.
|
||||
- Resizable window; `steam://` links open the Steam client.
|
||||
- The desktop app checks for a signed update on start and installs it when you say so, keeping your settings.
|
||||
- Same data path as the web app (`/api/data/*` on free-steam-games.win), same offline cache.
|
||||
@@ -78,7 +114,7 @@ npm run tauri:build # release binary into web/src-tauri/target/release/bundle
|
||||
<details>
|
||||
<summary><b>The admin at <code>/admin</code></b></summary>
|
||||
|
||||
`Discover New Games` sweeps the Steam store daily and proposes candidates into a Cloudflare D1 queue. The maintainer reviews them in a small Svelte app embedded in the Worker (never shipped to visitors): approving commits the store link to `scripts/temp_info.jsonl`, and the pipeline does the rest, checking every game again (free, a game, reachable) before it is published. Approval can also run on its own, in batches with a daily cap, once the maintainer turns it on. Decided and already-published rows are read-only. Corrections to published games are saved as override files that survive every pipeline run, and a removed game goes into `data/blocklist.jsonl`, which keeps it out of the catalogue until it is restored. An overview, the pipeline's runs and a data-quality report complete it. See [`docs/ADMIN.md`](docs/ADMIN.md).
|
||||
`Discover New Games` sweeps the Steam store daily for free games in every language, not only the ones that support English, and proposes candidates into a Cloudflare D1 queue. The maintainer reviews them in a small Svelte app embedded in the Worker (never shipped to visitors): approving commits the store link to `scripts/temp_info.jsonl`, and the pipeline does the rest, checking every game again (free, a game, reachable) before it is published. Approval can also run on its own, in batches with a daily cap, once the maintainer turns it on. Decided and already-published rows are read-only. Corrections to published games are saved as override files that survive every pipeline run, and a removed game goes into `data/blocklist.jsonl`, which keeps it out of the catalogue until it is restored. An overview, the pipeline's runs and a data-quality report complete it. See [`docs/ADMIN.md`](docs/ADMIN.md).
|
||||
|
||||
</details>
|
||||
|
||||
@@ -89,8 +125,8 @@ The Python pipeline that powered v2 is untouched and runs daily as before:
|
||||
|
||||
- Schema v2.2 (23 + manual fields per record), CC BY 4.0 (see [LICENSE-DATA](LICENSE-DATA)), sharded data in `data/data_*.jsonl` (cap 800 records/shard) plus a `data/index.json` manifest with a SHA-256 per shard.
|
||||
- HTML scraper for accurate language tables, DLC pricing, user tags and the developer's anti-cheat disclosure — single GET per game.
|
||||
- Health-checked: dead-link sweep every 5 days, full purge every Monday.
|
||||
- Reviews-only refresh every 2 days; full refresh daily.
|
||||
- Health-checked daily: Steam's store API screens every game, and a game is removed only when appdetails agrees.
|
||||
- Reviews refreshed daily from Steam's own summaries; full refresh daily. Every data job queues for its turn and has a time budget, so a growing catalogue slows a refresh down instead of breaking it ([plan](docs/plan/18-pipeline-scale.md)).
|
||||
|
||||
</details>
|
||||
|
||||
@@ -100,9 +136,11 @@ The Python pipeline that powered v2 is untouched and runs daily as before:
|
||||
```
|
||||
.
|
||||
├── data/ # Sharded data (the source of truth)
|
||||
│ ├── data_001.jsonl # ≤ 800 records
|
||||
│ ├── data_002.jsonl … 005 # the rest
|
||||
│ └── index.json # last_updated, totals, shard manifest
|
||||
│ ├── data_001.jsonl … # 800 records per shard, as many shards as it takes
|
||||
│ ├── index.json # last_updated, totals, shard manifest (SHA-256 each)
|
||||
│ ├── blocklist.jsonl # removed games, kept out of every write
|
||||
│ ├── overrides/ # human corrections, re-applied on every write
|
||||
│ └── snapshots/ # daily per-game players and reviews
|
||||
│
|
||||
├── games/ # The two generated leaderboards
|
||||
│ ├── top-online.md # live leaderboard
|
||||
@@ -127,7 +165,7 @@ The Python pipeline that powered v2 is untouched and runs daily as before:
|
||||
│ ├── src-tauri/ # Tauri 2 desktop + Android shell (Rust)
|
||||
│ └── static/ # icons, social image, robots.txt, _headers
|
||||
│
|
||||
├── docs/ # Legal + acknowledgements + contact
|
||||
├── docs/ # Legal, setup and ops docs, plans (plan/), Vietnamese copies (i18n/vi/)
|
||||
├── .github/workflows/ # data pipeline, discovery, CI, desktop/Android release
|
||||
├── LICENSE # MIT — code
|
||||
└── LICENSE-DATA # CC BY 4.0 — dataset
|
||||
@@ -151,7 +189,8 @@ scripts/
|
||||
│ ├── anticheat.py # Steam's anti-cheat disclosure and the rule that applies it
|
||||
│ ├── steamcharts.py # SteamCharts all-time peak reader (polite, stops on refusal)
|
||||
│ ├── peaks.py # all_time_peak: only ever raised
|
||||
│ ├── rotation.py # crc32 daily slices shared by the refresh jobs
|
||||
│ ├── rotation.py # crc32 daily slices shared by the refresh jobs, growing with the catalogue
|
||||
│ ├── budget.py # A job's time budget: stop in time to save, warn before it runs out
|
||||
│ └── health_checker.py # Game status detection with cached API data
|
||||
├── discover_new.py # Propose new games into the /admin review queue
|
||||
├── ingest_new.py # Add queued games (health check + fetch from Steam)
|
||||
@@ -160,13 +199,12 @@ scripts/
|
||||
├── refresh_store_data.py # Daily rotation: tags/languages weekly, store details monthly
|
||||
├── refresh_anticheat.py # Daily: every game's anti-cheat, as its developer declares it on Steam
|
||||
├── refresh_peaks.py # Daily rotation: all-time peak from SteamCharts, monthly per game
|
||||
├── update_reviews.py # Reviews-only (every 2 days)
|
||||
├── update_reviews.py # Daily: every game's review summary from Steam, ~2 minutes
|
||||
├── mark_dead_games.py # Flag online games with no players
|
||||
├── check_dead_links.py # HEAD-request 404/410 scanner
|
||||
├── purge_unhealthy.py # Remove delisted/not-free/invalid
|
||||
├── purge_unhealthy.py # Daily: remove delisted/not-free/unreleased (store API screen + appdetails)
|
||||
├── top_online.py / top_offline.py # Leaderboards
|
||||
├── edit_game.py # Overrides from the command line
|
||||
├── refetch_all.py # Force re-fetch ALL (manual only)
|
||||
├── refetch_all.py # Force re-fetch, in parts (manual only)
|
||||
└── delete_game.py # Remove games (blocklist) from the command line
|
||||
```
|
||||
|
||||
@@ -177,51 +215,61 @@ scripts/
|
||||
| Workflow | Trigger | What it does |
|
||||
| --------------------- | -------------------------------- | --------------------------------------------------------- |
|
||||
| Auto Update JSON | Daily 00:00 UTC | Fills in incomplete records (API + HTML scrape) |
|
||||
| Discover New Games | Daily 05:00 UTC | Propose new free games into the `/admin` review queue |
|
||||
| Discover New Games | Daily 05:00 UTC | Propose new free games, any language, to the `/admin` queue |
|
||||
| Ingest New | On `scripts/temp_info.jsonl` or `data/blocklist.jsonl` push, and every 3 h | Apply removals, then add approved games |
|
||||
| Top Online | Sun/Wed/Fri 03:00 UTC | Live player leaderboard |
|
||||
| Top Offline | 1st + 15th of month 05:00 UTC | Leaderboard for single-player F2P concurrents |
|
||||
| Update Reviews | Every 2 days 06:00 UTC | Reviews-only refresh |
|
||||
| Update Reviews | Daily 06:00 UTC | Every game's review summary from Steam's store API |
|
||||
| Refresh Store Data | Daily 16:00 UTC | Rotating re-fetch: tags, languages, DLC flag weekly; name, image, description, developer/publisher, release date, platforms, Metacritic, DRM monthly. Then every game's anti-cheat from Steam's disclosure (committed separately; manual run with `only: anticheat` does just that) |
|
||||
| Refresh All-Time Peaks | Daily 19:30 UTC | `all_time_peak` from SteamCharts, every game once a month, plus our own samples; manual run with `backfill` asks about every game |
|
||||
| Check Dead Links | Every 5 days 04:00 UTC | HEAD-request 404/410 scanner |
|
||||
| Purge Unhealthy | Weekly Mon 05:00 UTC | Full health scan + removal |
|
||||
| Purge Unhealthy | Daily 07:00 UTC | Store API screen of every game; removal once appdetails agrees |
|
||||
| Mark Dead Games | Mon + Thu 04:30 UTC | Online + >1y + 0 players ≥14d → `is_dead=true` + 💀 note |
|
||||
| Daily Snapshot | Daily 23:00 UTC | Per-game players and reviews into `data/snapshots/` |
|
||||
| Force Re-fetch | Manual only | Re-fetch ALL games |
|
||||
| Force Re-fetch | Manual only | Re-fetch games from scratch, one part (`1/8` … `8/8`) a run |
|
||||
| Web CI / Python Tests | On `web/**` / `scripts/**` change | Type check, tests, build and output checks |
|
||||
| Release Desktop / Android | On `desktop-v*` / `android-v*` tag | Build the apps into a draft release |
|
||||
| Announce Discussion | On release `published` | Auto-create a GitHub Discussion in `Announcements` |
|
||||
|
||||
The site itself is deployed by Cloudflare Workers Builds on every push to `main`, not by a workflow.
|
||||
Also in `.github/workflows/`:
|
||||
- **CodeQL**, **SonarCloud** and **Qodana** (Python, JS/TS, Rust): code scanning on pushes and pull requests.
|
||||
- **Check Overrides**: pull requests that touch the override or blocklist files.
|
||||
- **Backfill Discovery**: temporary; a weekly re-sweep of older release windows into the same `/admin` queue.
|
||||
- **Announce Release to Discord**: posts each published release.
|
||||
- Three **Notify** workflows: CI failures, the Pages deploy, the release pipeline.
|
||||
- **Deploy Web (GitHub Pages)**: it only serves a redirect to the new site now.
|
||||
|
||||
The site itself is deployed by Cloudflare Workers Builds, not by a workflow.
|
||||
|
||||
### Contribute
|
||||
|
||||
The repository is in [maintenance mode](#project-status): contributions are
|
||||
about the **data**.
|
||||
|
||||
New games arrive on their own: `Discover New Games` sweeps the Steam store
|
||||
daily into a review queue, and the maintainer approves them at `/admin` — by
|
||||
daily, in every language, into a review queue, and the maintainer approves them at `/admin` — by
|
||||
hand, or with an auto-approve rule that has a daily cap and is off until turned
|
||||
on. Discovery only proposes, and every approved game is checked again by the
|
||||
pipeline (free, a game, reachable) before it is published. Missing a free game
|
||||
a few days after it went free? Post its store link in
|
||||
[Discussions › Ideas](https://github.com/poli0981/free-steam-games-list/discussions/categories/ideas).
|
||||
pipeline (free, a game, reachable) before it is published.
|
||||
|
||||
The companion browser extension, [steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension),
|
||||
is archived and no longer a way in.
|
||||
|
||||
**Issues** are for reports, not submissions:
|
||||
[Bug report](.github/ISSUE_TEMPLATE/bug_report.yml),
|
||||
[Feature request](.github/ISSUE_TEMPLATE/feature_request.yml),
|
||||
[Delete game](.github/ISSUE_TEMPLATE/delete_game.yml) and
|
||||
[Feedback](.github/ISSUE_TEMPLATE/feedback.yml). All reviewed by hand.
|
||||
|
||||
**The manual way.** Fork, append store links to `scripts/temp_info.jsonl`, and open a pull request:
|
||||
| You want to | Issue form | Or a pull request that |
|
||||
| --- | --- | --- |
|
||||
| **Add** a free game that is still missing a few days after it went free | [Add game](.github/ISSUE_TEMPLATE/add_game.yml) | appends its store link to `scripts/temp_info.jsonl` |
|
||||
| **Correct** a published game (genre, type, anti-cheat, notes, safe) | [Edit game](.github/ISSUE_TEMPLATE/edit_game.yml) | adds an override with `python scripts/edit_game.py <appid> --set field=value --reason "…"` |
|
||||
| **Remove** a game (paid now, not a game, malware, duplicate) | [Delete game](.github/ISSUE_TEMPLATE/delete_game.yml) | adds a blocklist line with `python scripts/delete_game.py <appid> --reason <code>` |
|
||||
|
||||
```jsonl
|
||||
{"link": "730"}
|
||||
{"link": "https://store.steampowered.com/app/570/"}
|
||||
```
|
||||
|
||||
Accepts a full URL, short URL, or bare appid. A line is a link and nothing else: any other key is ignored, and the game is fetched from Steam. A correction to a published game (genre, anti-cheat, notes…) goes in a Discussion; the maintainer records it as an override.
|
||||
A queued line accepts a full URL, short URL, or bare appid, and is a link and nothing else: any other key is ignored, and the game is fetched from Steam. Never edit `data/data_*.jsonl` or `data/index.json` by hand: the pipeline rewrites them, and an edit there is lost.
|
||||
|
||||
Two more forms stay open, for things that are broken rather than wished for:
|
||||
[Bug report](.github/ISSUE_TEMPLATE/bug_report.yml) and
|
||||
[Accessibility barrier](.github/ISSUE_TEMPLATE/accessibility.yml). All reviewed by hand.
|
||||
|
||||
The companion browser extension, [steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension),
|
||||
is archived and no longer a way in.
|
||||
|
||||
See [CONTRIBUTING.md](CONTRIBUTING.md) for the full flow.
|
||||
|
||||
@@ -234,6 +282,7 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
|
||||
- v2.1 was spaghetti with proper seasoning. It got a scraper.
|
||||
- v3.0 was spaghetti with a website on top, a desktop app, and bilingual menus.
|
||||
- **v4.0 is the same spaghetti, rebuilt, with a review queue so it stops needing to be cooked by hand.** Still a hobby.
|
||||
- v4.7 is where the cooking stops: the dish is served, and from here it is only kept warm.
|
||||
|
||||
> [!WARNING]
|
||||
> **Disclaimer.** Quality / fun / safety: who knows. The maintainer only vouches for games personally played (`safe` column: `y` = yes, `?` = dunno, `n` = nope). Problems with a game are between you, Valve, and the developer of that game — not the maintainer. See [`docs/DISCLAIMER.md`](docs/DISCLAIMER.md) for the specific accuracy caveats.
|
||||
@@ -241,10 +290,10 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
|
||||
### Docs
|
||||
|
||||
- [AUTHORS](AUTHORS.md) — maintainer + canonical handle map + AI-assistant disclosure.
|
||||
- [CHANGELOG](CHANGELOG.md) — what changed in each version.
|
||||
- [CONTRIBUTING](CONTRIBUTING.md) — issue templates, suggesting a game, manual fork.
|
||||
- [CHANGELOG](CHANGELOG.md) — what changed in each version: the index, with one file per release in [`changelog/`](changelog/).
|
||||
- [CONTRIBUTING](CONTRIBUTING.md) — maintenance mode, what is accepted, and how to add, correct or remove a game.
|
||||
- [PC spec](docs/pc_spec.md) ([VI](docs/i18n/vi/pc_spec.md)) — maintainer's dev hardware + test devices.
|
||||
- [Dev environment](docs/dev_env.md) ([VI](docs/i18n/vi/dev_env.md)) — IDE, toolchains (Python 3.12 / Node 24 / Rust stable / Tauri 2), workflow.
|
||||
- [Dev environment](docs/dev_env.md) ([VI](docs/i18n/vi/dev_env.md)) — IDE, toolchains (Python 3.15 / Node 26 / TypeScript 7 / Rust stable / Tauri 2), workflow.
|
||||
- [Tauri build](web/src-tauri/TAURI.md) — desktop build prerequisites + signing + auto-update.
|
||||
- [DISCLAIMER](docs/DISCLAIMER.md) — accuracy caveats, no-warranty, the broke-maintainer note.
|
||||
- [Terms of Use](docs/ToS.md) — usage agreement, contributions, governing law.
|
||||
@@ -257,7 +306,10 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
|
||||
- [Contact](docs/Contact.md) — where to find the maintainer.
|
||||
- [CODE OF CONDUCT](CODE_OF_CONDUCT.md) — be chill.
|
||||
- [SECURITY](SECURITY.md) — vulnerability reporting.
|
||||
- [`web/README.md`](web/README.md) — stack details, per-phase changelog, build instructions.
|
||||
- [Security setup](docs/SECURITY_SETUP.md) — the operational side: headers, WAF, rate limits, Access, each with a check command.
|
||||
- [ACCESSIBILITY](ACCESSIBILITY.md) — what works with a keyboard, screen reader and zoom, what doesn't yet, and how to report a barrier.
|
||||
- [Android support](docs/android-support.md) ([VI](docs/i18n/vi/android-support.md)) — why Android 11+, and what the APK is tested on.
|
||||
- [`web/README.md`](web/README.md) — web stack, data paths, CSP, PWA, i18n, build and checks.
|
||||
|
||||
Code is [MIT](LICENSE); the dataset is [CC BY 4.0](LICENSE-DATA) with carve-outs for fields the project does not own (`description`, `header_image`). Keep the right licence with you if you fork. Star if you find a hidden gem ✨
|
||||
|
||||
|
||||
+27
-11
@@ -6,17 +6,21 @@ The previous version of this file said the repository was "just a Markdown
|
||||
list… no executable code, no dependencies, no backend, no user data." That was
|
||||
wrong on every count, so here is the real picture:
|
||||
|
||||
- a **Cloudflare Worker** serving the site, holding a D1 binding and — for the
|
||||
admin path — a credential that can write to this repository
|
||||
- a **React single-page app** with a few dozen npm dependencies
|
||||
- a **Cloudflare Worker** serving the site. It holds a D1 binding, an R2
|
||||
bucket for the game art (public at `media.free-steam-games.win`), a
|
||||
15-minute cron (reconcile, auto-approve, and minting the art into that
|
||||
bucket), and, for the admin path, a credential that can write to this
|
||||
repository
|
||||
- a **SvelteKit / Svelte 5 web app**, prerendered to static pages, with a few
|
||||
dozen npm dependencies, plus the `/admin` app embedded in the Worker
|
||||
- a **Tauri 2 desktop and Android app**, signed, with an auto-updater
|
||||
Operational hardening — headers, HSTS, rate limiting, WAF — is documented in
|
||||
- a **Python pipeline** run by GitHub Actions. The data jobs push to `main`
|
||||
with the built-in `GITHUB_TOKEN`; the release jobs hold the app signing keys
|
||||
|
||||
Operational hardening (headers, HSTS, rate limiting, WAF) is documented in
|
||||
[`docs/SECURITY_SETUP.md`](docs/SECURITY_SETUP.md), with a check command for
|
||||
each item.
|
||||
|
||||
- a **Python pipeline** run by 23 GitHub Actions workflows, several holding
|
||||
secrets that can push to `main`
|
||||
|
||||
There is genuinely something to attack here. Hence a real policy.
|
||||
|
||||
## Reporting
|
||||
@@ -46,17 +50,21 @@ reproduce. A proof-of-concept URL beats a paragraph of description.
|
||||
|
||||
- The Cloudflare Worker (`web/worker/**`) — the data proxy, the image proxy,
|
||||
and anything reachable under `/api/*`
|
||||
- The `/admin` path and its Cloudflare Access gate
|
||||
- The `/admin` path and `/api/ingest/*`, and their Cloudflare Access gates
|
||||
- The D1 database and anything that writes to it
|
||||
- The media host, `media.free-steam-games.win` (the R2 bucket's public
|
||||
domain), and whatever the cron writes to it
|
||||
- The GitHub Actions workflows, especially any path where untrusted input
|
||||
reaches a step that can push to `main`
|
||||
- The Tauri updater and its signing key
|
||||
- The Tauri updater, its signing key, and its feed at `/api/updates/desktop`
|
||||
- Dependency vulnerabilities that are actually reachable from shipped code
|
||||
|
||||
Things worth probing specifically: making `/img/*` fetch an origin that is not
|
||||
`shared.akamai.steamstatic.com` or `shared.fastly.steamstatic.com`; making
|
||||
`shared.akamai.steamstatic.com` or `shared.fastly.steamstatic.com` (or, for
|
||||
the avatars under `/img/gh/*`, `avatars.githubusercontent.com`); making
|
||||
`/api/data/*` return a path outside its allowlist; reaching admin
|
||||
functionality without an Access session.
|
||||
functionality without an Access session; getting the update feed to offer a
|
||||
file that is not this repository's release download.
|
||||
|
||||
## Out of scope
|
||||
|
||||
@@ -72,6 +80,8 @@ functionality without an Access session.
|
||||
already read. A way to make `/api/human-check` accept a token Cloudflare
|
||||
rejected is in scope.
|
||||
- Social engineering of the maintainer.
|
||||
- Accessibility barriers. They are real bugs, but not security ones: see
|
||||
[`ACCESSIBILITY.md`](ACCESSIBILITY.md).
|
||||
|
||||
## What to expect
|
||||
|
||||
@@ -86,3 +96,9 @@ broke are not a joke. Credit in `docs/ACKNOWLEDGEMENTs.md` if you want it.
|
||||
|
||||
The deployed site and `main` are the only supported versions. Desktop and
|
||||
Android releases are supported at the latest tag only; there are no backports.
|
||||
|
||||
The project is stable and in maintenance mode (see
|
||||
[`CONTRIBUTING.md`](CONTRIBUTING.md)): no new features are developed, and
|
||||
security fixes and runtime / dependency updates are exactly what it is still
|
||||
maintained for. Dependabot, CodeQL and SonarCloud keep running, and a fix
|
||||
ships as a new site deploy and, when the apps are affected, a new app release.
|
||||
+7
-8
@@ -1,13 +1,12 @@
|
||||
#!/bin/bash
|
||||
# Commit what a data job changed, and push it even if main moved meanwhile.
|
||||
#
|
||||
# A data job can run for hours (update-reviews, check-dead-links,
|
||||
# purge-unhealthy), and `concurrency: data-write` serialises only the
|
||||
# WORKFLOWS. main still moves underneath one: a merged pull request, an /admin
|
||||
# approval, removal or override the Worker commits. A plain `git push` is then
|
||||
# rejected ("fetch first")
|
||||
# and the whole run is thrown away - purge-unhealthy lost four hours of work
|
||||
# that way on 2026-09-21.
|
||||
# A data job can run for an hour or more (refresh-store-data, the
|
||||
# leaderboards), and `concurrency: data-write` serialises only the WORKFLOWS.
|
||||
# main still moves underneath one: a merged pull request, an /admin approval,
|
||||
# removal or override the Worker commits. A plain `git push` is then rejected
|
||||
# ("fetch first") and the whole run is thrown away - purge-unhealthy lost four
|
||||
# hours of work that way on 2026-09-21.
|
||||
#
|
||||
# None of those other writers touch the shards, so rebasing onto them and
|
||||
# pushing again is safe. A genuine conflict still fails the job, loudly.
|
||||
@@ -17,7 +16,7 @@ set -euo pipefail
|
||||
|
||||
msg="$1"
|
||||
shift
|
||||
if [ "$#" -eq 0 ]; then
|
||||
if [[ "$#" -eq 0 ]]; then
|
||||
set -- .
|
||||
fi
|
||||
|
||||
|
||||
@@ -1,5 +0,0 @@
|
||||
#!/bin/bash
|
||||
set -euo pipefail
|
||||
pip install --quiet -r requirements.txt
|
||||
python scripts/check_dead_links.py
|
||||
bash "$(dirname "$0")/commit_push.sh" "Dead link check [$(date +'%Y-%m-%d')]"
|
||||
+5
-4
@@ -3,11 +3,12 @@
|
||||
#
|
||||
# remove_games.py applies data/blocklist.jsonl (games the maintainer removed in
|
||||
# /admin or with delete_game.py) before ingest_new.py adds the queued links.
|
||||
# One workflow does both on purpose: `data-write` keeps ONE pending run and a
|
||||
# newer one evicts it, so a separate removal workflow and the ingest would keep
|
||||
# cancelling each other. Whichever run survives does both.
|
||||
# One workflow does both: a commit to either file starts one run that settles
|
||||
# the two, in that order. (It was also the only way to do it while
|
||||
# `data-write` kept a single pending run and a separate removal workflow and
|
||||
# the ingest kept evicting each other; the group queues them now.)
|
||||
set -euo pipefail
|
||||
pip install --quiet -r requirements.txt
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
python scripts/remove_games.py
|
||||
python scripts/ingest_new.py
|
||||
|
||||
|
||||
+1
-1
@@ -1,5 +1,5 @@
|
||||
#!/bin/bash
|
||||
set -euo pipefail
|
||||
pip install --quiet -r requirements.txt
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
python scripts/update_data.py
|
||||
bash "$(dirname "$0")/commit_push.sh" "Auto update [$(date +'%Y-%m-%d')]"
|
||||
+1
-1
@@ -1,5 +1,5 @@
|
||||
#!/bin/bash
|
||||
set -euo pipefail
|
||||
pip install --quiet -r requirements.txt
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
python scripts/top_offline.py
|
||||
bash "$(dirname "$0")/commit_push.sh" "Top offline [$(date +'%Y-%m-%d %H:%M')]"
|
||||
+1
-1
@@ -1,5 +1,5 @@
|
||||
#!/bin/bash
|
||||
set -euo pipefail
|
||||
pip install --quiet -r requirements.txt
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
python scripts/top_online.py
|
||||
bash "$(dirname "$0")/commit_push.sh" "Top online [$(date +'%Y-%m-%d %H:%M')]"
|
||||
+8
-1
@@ -1,5 +1,12 @@
|
||||
#!/bin/bash
|
||||
set -euo pipefail
|
||||
pip install --quiet -r requirements.txt
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
# PURGE_DRY_RUN is the manual run's "dry run" box: screen and confirm, remove nothing.
|
||||
# A guard that trips (too many flagged or confirmed) exits non-zero before
|
||||
# anything is written, so set -e stops here and nothing is committed.
|
||||
if [[ "${PURGE_DRY_RUN:-}" == "true" ]]; then
|
||||
python scripts/purge_unhealthy.py --dry-run
|
||||
exit 0
|
||||
fi
|
||||
python scripts/purge_unhealthy.py
|
||||
bash "$(dirname "$0")/commit_push.sh" "Purge unhealthy [$(date +'%Y-%m-%d')]"
|
||||
+7
-4
@@ -1,7 +1,10 @@
|
||||
#!/bin/bash
|
||||
set -euo pipefail
|
||||
echo "── Force re-fetch ALL games (v2.1 schema) ──"
|
||||
# REFETCH_PART is the manual run's "part" box, K/N (scripts/refetch_all.py
|
||||
# checks it): the whole catalogue no longer fits in one job.
|
||||
part="${REFETCH_PART:-1/1}"
|
||||
echo "── Force re-fetch, part ${part} ──"
|
||||
|
||||
pip install --quiet -r requirements.txt
|
||||
python scripts/refetch_all.py
|
||||
bash "$(dirname "$0")/commit_push.sh" "Force re-fetch all games → v2.1 schema [$(date +'%Y-%m-%d')]"
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
python scripts/refetch_all.py --part "$part"
|
||||
bash "$(dirname "$0")/commit_push.sh" "Force re-fetch, part ${part} [$(date +'%Y-%m-%d')]"
|
||||
@@ -1,11 +1,11 @@
|
||||
#!/bin/bash
|
||||
set -euo pipefail
|
||||
pip install --quiet -r requirements.txt
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
# PEAKS_ALL is the manual run's "backfill" box: "true" asks SteamCharts about
|
||||
# every game (~4 h) instead of today's thirtieth. A scheduled run leaves it
|
||||
# empty, and an unticked box sends "false" - neither may pass --all.
|
||||
args=()
|
||||
if [ "${PEAKS_ALL:-}" = "true" ]; then
|
||||
if [[ "${PEAKS_ALL:-}" == "true" ]]; then
|
||||
args+=(--all)
|
||||
fi
|
||||
python scripts/refresh_peaks.py ${args[@]+"${args[@]}"}
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
#!/bin/bash
|
||||
set -euo pipefail
|
||||
pip install --quiet -r requirements.txt
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
# REFRESH_ONLY from a manual run: "page" or "details" runs that group of the
|
||||
# store refresh, "anticheat" only the anti-cheat sweep; empty = everything.
|
||||
# Each part commits on its own, so a failure in the sweep never costs the
|
||||
# store refresh its push (and set -e still stops at a crash in either).
|
||||
if [ "${REFRESH_ONLY:-}" != "anticheat" ]; then
|
||||
if [[ "${REFRESH_ONLY:-}" != "anticheat" ]]; then
|
||||
python scripts/refresh_store_data.py ${REFRESH_ONLY:+--only "$REFRESH_ONLY"}
|
||||
bash "$(dirname "$0")/commit_push.sh" "Refresh store data [$(date +'%Y-%m-%d')]"
|
||||
fi
|
||||
if [ -z "${REFRESH_ONLY:-}" ] || [ "${REFRESH_ONLY:-}" = "anticheat" ]; then
|
||||
if [[ -z "${REFRESH_ONLY:-}" || "${REFRESH_ONLY:-}" == "anticheat" ]]; then
|
||||
python scripts/refresh_anticheat.py
|
||||
bash "$(dirname "$0")/commit_push.sh" "Refresh anti-cheat [$(date +'%Y-%m-%d')]"
|
||||
fi
|
||||
+6
-1
@@ -1,5 +1,10 @@
|
||||
#!/bin/bash
|
||||
set -euo pipefail
|
||||
pip install --quiet -r requirements.txt
|
||||
pip install --quiet --require-hashes --only-binary :all: -r requirements.txt
|
||||
# REVIEWS_DRY_RUN is the manual run's "dry run" box: read Steam, write nothing.
|
||||
if [[ "${REVIEWS_DRY_RUN:-}" == "true" ]]; then
|
||||
python scripts/update_reviews.py --dry-run
|
||||
exit 0
|
||||
fi
|
||||
python scripts/update_reviews.py
|
||||
bash "$(dirname "$0")/commit_push.sh" "Update reviews [$(date +'%Y-%m-%d')]"
|
||||
@@ -0,0 +1,14 @@
|
||||
# Changelog files
|
||||
|
||||
One file per release, newest version first in the index:
|
||||
[`CHANGELOG.md`](../CHANGELOG.md) at the root lists them all, with what is not
|
||||
released yet.
|
||||
|
||||
- `v<major>/<major>.<minor>.x/<version>.md` - a release, e.g.
|
||||
[`v4/4.7.x/4.7.1.md`](v4/4.7.x/4.7.1.md). Its first line is the release
|
||||
heading; the rest is the release notes, which is also what the GitHub
|
||||
release of that tag says.
|
||||
- [`beta/`](beta/) - pre-releases (none so far).
|
||||
|
||||
A file is written once, when its version is released, and is not reworded
|
||||
afterwards: it records what was true then, links and file names included.
|
||||
@@ -0,0 +1,9 @@
|
||||
# Pre-releases
|
||||
|
||||
Notes for a beta, alpha or release candidate go here, one file per
|
||||
pre-release, named for its version: `5.0.0-beta.1.md`. When the line goes
|
||||
stable its release gets a file of its own under `v<major>/`; the beta files
|
||||
stay, as the record of what changed during the run-up.
|
||||
|
||||
None has been published: every release so far, v1.0.0 to the latest in
|
||||
[`CHANGELOG.md`](../../CHANGELOG.md), was a stable one.
|
||||
@@ -0,0 +1,20 @@
|
||||
# v1.0.0 - 2025-12-22 (Initial stable release)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
From the GitHub release of v1.0.0 ("v1.0.0 - Released"); the changelog
|
||||
itself starts with v1.1.0.
|
||||
|
||||
First stable release – the repo is alive!
|
||||
|
||||
- Auto daily fresh stats + immediate update on data.json push
|
||||
- Tables with thumbnails, reviews sort best first, safe/noob notes
|
||||
- Genre files + top online multiplayer
|
||||
- Chained workflows, robust fetch/generate
|
||||
- Bug/feature templates
|
||||
|
||||
From a broke unemployed Vietnamese dev (Easy mode only) + Grok AI buddy 70% power.
|
||||
|
||||
Thanks for starring/watching – wallet safe, play free games :))
|
||||
|
||||
Next? More games, more noob notes, maybe dynamic badges if not lazy.
|
||||
@@ -0,0 +1,10 @@
|
||||
# v1.1.0 - 2025-12-30 (Scale Noob Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
- Split all-games.md into parts. Smart fetch skip. Wiki. Issue templates.
|
||||
- Batch + delay optimize for 500+ games. Various Action fixes.
|
||||
|
||||
Previous: [v1.0.0] – Initial stable.
|
||||
|
||||
Made with boredom, instant noodles, sale addiction, and AI power ✨
|
||||
@@ -0,0 +1,5 @@
|
||||
# v1.1.1 - 2026-01-07
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
- 50+ games, delete/dedup scripts, CSV export, auto CSV Actions. (by [@poli0981](https://github.com/poli0981))
|
||||
@@ -0,0 +1,5 @@
|
||||
# v1.1.2 - 2026-01-11
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
- 40+ games added.
|
||||
@@ -0,0 +1,8 @@
|
||||
# v1.1.3 - 2026-01-15
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
From the message of the tag `v1.1.3`; it has no GitHub release and
|
||||
had no section in the changelog.
|
||||
|
||||
- 30+ games added.
|
||||
@@ -0,0 +1,17 @@
|
||||
# v2.0.0 - 2026-03-26 (The "Finally Got Serious" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
## 💥 Breaking Changes
|
||||
|
||||
- Data format migrated from `data.json` to `data.jsonl` (JSON Lines).
|
||||
- All Python scripts rewritten from scratch under `scripts/core/` modular architecture.
|
||||
- Bash scripts rewritten with `set -euo pipefail`.
|
||||
|
||||
## 🏗️ Architecture (Complete Rewrite)
|
||||
|
||||
- Modular core: `constants.py`, `steam_client.py`, `data_store.py`, `fetcher.py`, `health_checker.py`.
|
||||
- Rate-limited HTTP client with backoff, retry, 429 handling, session pooling.
|
||||
- Health detection (5 statuses), purge, dead link check, pre-flight ingest validation.
|
||||
- New ingest flow: `temp_info.jsonl` → validate → dedup → health check → fetch → `data.jsonl`.
|
||||
- 9 CI/CD workflows. Metacritic, DRM, Peak Today, Status columns. Top Online leaderboard with trends.
|
||||
@@ -0,0 +1,85 @@
|
||||
# v2.1.0 - 2026-03-28 (The "Extension-Ready + Performance" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
## 💥 Breaking Changes
|
||||
|
||||
- `desc` field **removed** from schema. Use `description` only. Migration script handles upgrade automatically.
|
||||
- `free_type` field removed (unreliable from API, extension handles classification client-side).
|
||||
- `jsonlines` pip dependency dropped – all I/O now uses stdlib `json` (faster, zero deps).
|
||||
- `fetcher.py` function renamed: `_process_batch()` → `process_batch()` (public API).
|
||||
|
||||
## 🏗️ Schema v2.1 (Extension-Compatible)
|
||||
|
||||
- **7 new fields** added to every game record, matching Chrome extension output:
|
||||
- `publisher` (list) – e.g. `["Square Enix", "Feral Interactive (Mac)"]`
|
||||
- `platforms` (list) – e.g. `["Windows", "macOS", "Linux"]`
|
||||
- `languages` (list) – e.g. `["English", "French", "Japanese"]`
|
||||
- `language_details` (list[dict]) – per-language `{name, interface, audio, subtitles}` booleans
|
||||
- `tags` (list) – all user-defined Steam tags including hidden overflow
|
||||
- `anti_cheat_note` (str) – raw anti-cheat name from store page
|
||||
- `is_kernel_ac` (bool|null) – `true` = kernel-level, `false` = non-kernel, `null` = unknown
|
||||
- `developer` normalized: string → list everywhere (API, extension, migration).
|
||||
- `desc` merged into `description`, then dropped. One field, no duplication.
|
||||
|
||||
## 🔌 Extension Data Integration
|
||||
|
||||
- New `merge_extension_data()` in `data_store.py` – smart merge with 3-tier priority:
|
||||
- **MANUAL_FIELDS** (notes, safe, type_game, genre, anti_cheat): only fill if empty (preserves user edits).
|
||||
- **ARRAY_FIELDS** (developer, publisher, platforms, languages, tags): replace wholesale (extension data is richer).
|
||||
- **Other fields**: overwrite if extension provides non-empty value.
|
||||
- `ingest_new.py` now accepts full extension output (20+ fields per entry) – merges before fetch, re-applies manual
|
||||
overrides after fetch.
|
||||
- Ingest summary shows field counts: `dev=DONTNOD plat=[Windows, macOS, Linux] langs=6 tags=20`.
|
||||
|
||||
## 🔍 HTML Scraper (New Module)
|
||||
|
||||
- New `scraper.py` – extracts data unavailable from Steam API:
|
||||
- **Language table**: parses `<table class="game_language_options">` → accurate Interface/Audio/Subtitles per
|
||||
language (API only gives a broken HTML string with no subtitle info).
|
||||
- **DLC pricing**: parses `#gameAreaDLCSection` → checks `data-price-final` per DLC row. Only marks
|
||||
`has_paid_dlc=true` if at least one DLC has actual non-zero price (API just lists DLC IDs with no prices).
|
||||
- **Tags**: parses `.app_tag` elements including `display:none` overflow tags (API `appdetails` doesn't return user
|
||||
tags at all).
|
||||
- All 3 extracted from **single GET request** to store page – one HTML fetch per game, not three.
|
||||
- 8 regex patterns pre-compiled at module level.
|
||||
|
||||
## ⚡ Performance Optimizations
|
||||
|
||||
- **Eliminated double-fetch in ingest**: `health_checker` now caches API response in `HealthResult.data`.
|
||||
`ingest_new.py` passes `prefetched_details=health.data` to `fetch_full()` → skips redundant `fetch_app_details()`
|
||||
call. Saves 1 API request per game (300 games = ~450s saved).
|
||||
- **Dropped jsonlines dependency**: `load_jsonl()` uses `json.loads()` line-by-line, `save_jsonl()` uses
|
||||
`json.dumps()` + `f.write()` directly. ~20-30% faster I/O for large files, zero pip deps for core.
|
||||
- **Pre-compiled regex**: `scraper.py` compiles all 8 patterns at import time, not per-call. 300 games = 8 compiles
|
||||
instead of 2400.
|
||||
- **Faster `is_empty()`**: uses `frozenset` lookup for empty string variants, early returns for `None`/`list`.
|
||||
- **`SteamClient.__slots__`**: reduced memory per instance, faster attribute access.
|
||||
- **`extract_appid()` regex simplified**: `/app/(\d+)` instead of full domain match – shorter, same correctness.
|
||||
- **`make_skeleton()` template**: shallow-copies from frozen template dict instead of building from scratch.
|
||||
- **`generate_tables.py`**: `lines.extend(generator)` instead of `append()` loop.
|
||||
|
||||
## 🔄 New Scripts & Workflows
|
||||
|
||||
- `refetch_all.py` + `refetch-all.yml` – **manual-only** force re-fetch of ALL games into v2.1 schema. Creates backup →
|
||||
migrates → clears fetchable fields → re-fetches from Steam API + HTML scrape. Preserves manual fields (notes, safe,
|
||||
type_game). Requires typing `"yes"` to confirm. Timeout: 120 minutes.
|
||||
- `migrate_schema.py` + `migrate-schema.yml` – upgrades existing `data.jsonl` records: adds missing fields, normalizes
|
||||
types, drops deprecated fields. Idempotent.
|
||||
|
||||
## 🐛 Bug Fixes
|
||||
|
||||
- **`languages` corrupted**: API HTML string `"Brazil<br>languages with full audio"` was parsed as
|
||||
`"Brazillanguages..."`. Fixed by switching to HTML table scraping.
|
||||
- **`subtitles` always `false`**: API has no subtitle breakdown. Fixed by parsing store page language table (
|
||||
Interface/Audio/Subtitles columns).
|
||||
- **`has_paid_dlc` false positives**: Games with free-only DLC were marked `true`. Fixed by scraping actual
|
||||
`data-price-final` attributes.
|
||||
- **`description` duplicated**: Both `desc` and `description` stored same text. Unified to `description` only.
|
||||
|
||||
## 🧹 Improved
|
||||
|
||||
- Tables: Publisher column, Platforms column, Language count, kernel anti-cheat badge (🔴/🟢).
|
||||
- `health_checker.py`: `@dataclass(slots=True)` for leaner objects.
|
||||
- `top_online.py`: tier thresholds as tuple list (cleaner).
|
||||
- All scripts: consistent `sys.path.insert(0, ...)` for imports.
|
||||
@@ -0,0 +1,50 @@
|
||||
# v3.0.0 – 2026-05-07 (The "It Has a Website Now" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The repo is no longer just a list. It is a **list + a React/Vite web app + a Tauri desktop app**, all reading the same Python-pipeline-maintained data.
|
||||
|
||||
## 🌐 Web app — `web/` + GitHub Pages
|
||||
|
||||
Built across phases 1 → 7. Live at <https://poli0981.github.io/free-steam-games-list/>.
|
||||
|
||||
- **Phase 1** — read-only browse: virtualised 1.2k-row TanStack table, faceted filters, Fuse.js fuzzy search, 4 ECharts MVP charts (KPI, top-online, genre treemap, platform donut), GitHub Pages deploy via `actions/deploy-pages`.
|
||||
- **Phase 2** — PAT-based GitHub auth, single-record edit drawer for the 8 manual fields, diff viewer, single + bulk Steam-link queue into `scripts/temp_info.jsonl`, conflict-retry, sonner toasts.
|
||||
- **Phase 3** — client-side OpenPGP signing via Git Data API: switched all writes from Contents API to `commitFile(getHead → createBlob → createTree → buildCommitContent → openpgp.sign → createCommit → updateRef)`. Settings panel with passphrase unlock + lock indicator. Earlier claim that PATs auto-sign was wrong — Contents API commits land Unverified.
|
||||
- **Phase 4** — fixed GPG salt-notation incompatibility (`config.nonDeterministicSignaturesViaNotation: false`) so OpenPGP.js v6 signatures parse on GitHub. Bulk edit + bulk delete in one signed multi-shard commit. 8 remaining charts (tags wordcloud, AC stacked, languages heatmap, release-year histogram, catalog-growth cumulative line, reviews histogram, online player tiers pie, DRM/DLC bars). Health page with workflow_dispatch buttons. ⌘K command palette (cmdk).
|
||||
- **Phase 4.1** — GPG signature payload fix: dropped trailing `\n` after the commit message so our signed bytes match `verification.payload` byte-for-byte. Verified via `gh api .../commits/{sha}.commit.verification.reason → valid`.
|
||||
- **Phase 5** — PWA (installable, offline shell + last-known data via Workbox), GPG identity override (multi-UID picker), GPG idle auto-lock 5/15/30/60 min, Activity feed page (`/activity`) with Verified-status badges + Me/Bots/All filters.
|
||||
- **Phase 6** — curated enums (`ANTI_CHEAT_ENUM`, `GENRE_ENUM`) + dropdowns, JSON-editor toggle in the edit drawer (full-record replace), manual-field overrides on Add (single + bulk JSON mode propagates `genre/type_game/anti_cheat/notes/safe` straight into `temp_info.jsonl`), GamesTable pagination 50/100/200/500/all + hidden scrollbar + per-row validation badge, per-game permalinks `/games/:appid` with friendly 404 drawer, verify-after-commit polling (toast updates with `verification.reason` once GitHub confirms), CSV/JSON export of the filtered subset, About page (repo + dev info from `username.txt` + 3rd-party stack + issue templates), topbar GPG quick-unlock popover, owner-gate (`useIsOwner` + `OWNER_LOGIN`) hides edit/add/delete UI from non-owners.
|
||||
- **Phase 6.1** — Edit Always Failing fix: Contents API caps `content` at 1 MB; `data/data_001.jsonl` is 1.49 MB so the read came back empty and every edit threw "Record not found". New `getRepoFileText()` helper falls back to the `/git/blobs/{sha}` endpoint for oversize files.
|
||||
- **Phase 6.2** — stale-after-edit fix: bumped `data/index.json.last_updated` in every shard-modifying commit AND switched the SW cache to `NetworkFirst` (raw.github CDN is Fastly-cached for 5 min). Plus optimistic-update helpers (`optimisticEdit/Replace/BulkEdit/BulkDelete`) write straight to TanStack + IndexedDB so the editor sees their own change instantly without waiting for the CDN.
|
||||
- **Phase 7** — date-column sort fix (`parseReleaseDate`), hamburger mobile nav (Sheet drawer, auto-close on route change), About expansion (Heads-up caveats + AI disclosure + legal links + per-third-party SPDX licence badges), legal docs rewritten (DISCLAIMER + EULA + ToS + PRIVACY) with the four caveats from `notes.txt` (genre best-effort, English-only, test-data leakage, unsigned-commit dev artefacts), refreshed `bug_report.yml`, workflow Node 20 → 24 + actions versions bumped.
|
||||
|
||||
## 🌍 i18n — vi / en (Phase 8, this release)
|
||||
|
||||
- `react-i18next` + `i18next-browser-languagedetector`. Resource files `src/i18n/locales/{en,vi}.json`.
|
||||
- Auto-detect from `navigator.language` on first load; persistent override via Settings → Language.
|
||||
- Sidebar nav, Topbar, Settings, Dashboard, Top Online, common buttons, common toast strings translated. Long-form legal copy stays English by design (legal review hard to mirror exactly across two languages).
|
||||
|
||||
## 🖥️ Desktop app — Tauri 2 (Phase 8, this release)
|
||||
|
||||
- `web/src-tauri/` Rust scaffold targeting Tauri 2. Single `main` window, fixed 1400 × 900, no resize, no maximise, dark theme, centred at startup.
|
||||
- `tauri-plugin-shell` for opening external links to Steam / GitHub from the embedded UI.
|
||||
- New `release-desktop.yml` workflow: matrix `ubuntu-latest` / `windows-latest` / `macos-latest`, Apple Silicon + Intel universal binaries, `tauri-apps/tauri-action`. Triggered by `desktop-v*` tags or manual workflow run. Each run creates a draft GitHub Release with `.msi` / `.dmg` / `.AppImage` / `.deb` assets.
|
||||
- `npm run tauri:dev` and `npm run tauri:build` from `web/` for local builds.
|
||||
|
||||
## 📦 Versioning
|
||||
|
||||
- Repo version badge **2.1.0 → 3.0.0**.
|
||||
- `web/package.json` **0.1.0 → 1.0.0** (web app considered first-stable).
|
||||
- `web/src-tauri/Cargo.toml` and `tauri.conf.json` ship at `1.0.0`.
|
||||
|
||||
## 📝 Docs (this release)
|
||||
|
||||
- `README.md` — rewrite: web app + desktop sections, updated Quick Links table, new architecture diagram, refreshed contribute paths, refreshed docs index.
|
||||
- `CHANGELOG.md` — this entry consolidating phases 1 → 8.
|
||||
- `docs/ACKNOWLEDGEMENTs.md` — refreshed with phase-by-phase AI assistance breakdown (Grok v1; Claude for v2 + the entire web/desktop layer + this changelog).
|
||||
- `web/README.md` — phase 8 status appended.
|
||||
|
||||
## 🛠️ Pipelines unchanged
|
||||
|
||||
- All 9 v2.x Python pipeline workflows (update-json, generate-tables, top-online, update-reviews, dead-link-check, purge-unhealthy, ingest-new, ingest-from-issue, refetch-all) keep their schedules and behaviour. Two new workflows added: `deploy-pages.yml` (Phase 1) and `release-desktop.yml` (Phase 8).
|
||||
@@ -0,0 +1,48 @@
|
||||
# v3.0.1 – 2026-05-07 (The "Desktop Actually Ships This Time" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Same-day post-v3.0.0 maintenance covering Phase 9 (auto-update foundations + CVE bumps + Device Flow scaffold), Phase 10 (Tauri build break + i18n full coverage + deps audit), and Phase 10.1 (minisign keypair rotation). The desktop release pipeline is now end-to-end green — `desktop-v1.0.0` finally produces signed `.msi` / `.exe` / `.dmg` / `.AppImage` / `.deb` / `.rpm` artefacts with a valid `latest.json` for auto-update.
|
||||
|
||||
## 🖥️ Phase 9 — auto-update foundations (#56)
|
||||
|
||||
- `tauri-plugin-updater` wired into `web/src-tauri/`. Endpoint pinned to the Releases page so installed clients fetch `latest.json` on launch.
|
||||
- Updater pubkey embedded in `tauri.conf.json` (gated behind a no-op for mobile builds via `#[cfg(not(any(target_os="android", target_os="ios")))]`).
|
||||
- GitHub Device Flow scaffold added to Settings: signed-in users no longer have to paste a long-lived PAT — they kick off `https://github.com/login/device`, type the user_code, and the app polls until token issuance. Falls back to PAT for the offline path.
|
||||
- Dependency CVE bumps (vite 5 → 7, vite-plugin-pwa 0.20 → 1.x). Path-traversal fix in source-map handling. No source changes required for the bumps.
|
||||
- More i18n: a chunk of edit-drawer / activity / dashboard chrome got proper translation keys.
|
||||
|
||||
## 🛠️ Phase 10 — Tauri build break + full i18n + deps audit (#57)
|
||||
|
||||
- **Tauri lib-name regression fixed.** Phase 9's auto-updater work introduced a `f2p_tracker_lib::run()` call in `main.rs` without declaring `[lib]` in `Cargo.toml`. Cargo's implicit lib name is `f2p_tracker` (hyphens → underscores from the package name) so the call failed to resolve and `cargo build` blew up. Added the explicit Tauri-2-template-style block:
|
||||
```toml
|
||||
[lib]
|
||||
name = "f2p_tracker_lib"
|
||||
crate-type = ["staticlib", "cdylib", "rlib"]
|
||||
```
|
||||
The triple crate-type keeps the door open for future `tauri ios init` / `tauri android init` work that `lib.rs`'s `#[cfg_attr(mobile, tauri::mobile_entry_point)]` already implies.
|
||||
- **i18n now reaches every chrome surface** (~150 new keys across new namespaces `charts`, `activity`, `add`, `system`, `cmdk`, `about`, `bulk`, `detail`, `diff`, `dialogs`, `health`). All 9 chart pages, Activity, Add, Health, Top Online, About headings, drawers (Edit / BulkEdit / Diff / GameDetail), `PwaIndicator`, `QueryState`, `GpgQuickUnlock`, `Topbar` tooltips/aria-labels, `Settings` rate-limit panel, `BulkActionBar` confirm dialog, `GamesTable` tooltips, and `CommandPalette` resolve through `useTranslation`. Long-form About prose stays English per the `settings.languageHint` policy. Enum values (anti-cheat / genre / type_game / safe) stay dataset-stable.
|
||||
- **Third-party deps audit.** Walked `web/package.json` against `About → Stack & third-party` and `docs/ACKNOWLEDGEMENTs.md`. Added missing entries: `react-router-dom`, the i18next stack (`i18next` + `react-i18next` + `i18next-browser-languagedetector`), Tauri 2 + plugins (shell / updater / process), `echarts-for-react`, the styling utilities (`class-variance-authority` / `clsx` / `tailwind-merge` / `tailwindcss-animate`), and PostCSS + autoprefixer. Vite version corrected 5 → 7 (was already bumped by Phase 9; About just hadn't caught up).
|
||||
- `ACKNOWLEDGEMENTs.md` restructured into grouped sections (runtime/build, styling, UI primitives, routing & i18n, data & state, charts, crypto & PWA, desktop) with deep links + SPDX licences.
|
||||
- `web/src-tauri/Cargo.lock` now committed for reproducible desktop builds.
|
||||
|
||||
## 🔑 Phase 10.1 — minisign keypair rotation (#58)
|
||||
|
||||
- `desktop-v1.0.0` was failing at the final sign-updater-bundle step:
|
||||
```
|
||||
failed to decode secret key: incorrect updater private key password:
|
||||
Missing comment in secret key
|
||||
```
|
||||
minisign formats the error so the inner "Missing comment" is the symptom of a wrong password — when the password is wrong, decryption returns garbage and the expected `untrusted comment: minisign encrypted secret key` header bytes don't appear. The original keypair's password was lost, so the GH secret could no longer decrypt the key.
|
||||
- Re-keyed via `npx tauri signer generate --ci -p ""` with no password. Stored at `~/.tauri/f2p-tracker{,.pub}` on the maintainer's box; `web/src-tauri/.gitignore` extended (`*.key`, `f2p-tracker{,.pub}`) as a guardrail in case keys ever land in `src-tauri/` during dev.
|
||||
- New pubkey baked into `tauri.conf.json` `plugins.updater.pubkey`. GH secrets `TAURI_SIGNING_PRIVATE_KEY` and `TAURI_SIGNING_PRIVATE_KEY_PASSWORD` rotated via `gh secret set` (password = empty string).
|
||||
- **Trade-off**: any user already on a build signed with the old key would have their auto-update break. Nobody hit that path because Phase 9 / Phase 10 release runs both failed before publishing artefacts. Phase 10.1's rebuild is the first actually-shipped `desktop-v1.0.0`.
|
||||
|
||||
## 🏷️ Tag handling
|
||||
|
||||
- `desktop-v1.0.0` was force-pushed twice in this cycle as the workflow input commit advanced (Phase 9 → Phase 10 → Phase 10.1). The triggering tag is GPG-signed each time. Once the auto-update story is real users-on-it, future fixes should bump `desktop-v1.0.x` instead of force-pushing.
|
||||
|
||||
## 📝 Docs (this release)
|
||||
|
||||
- `CHANGELOG.md` — this entry.
|
||||
- `web/src-tauri/Cargo.toml` + `tauri.conf.json` + `.gitignore` — Phase 10 / 10.1 changes documented in their own commit messages and PR bodies (#57, #58).
|
||||
@@ -0,0 +1,60 @@
|
||||
# v3.1.0 – 2026-05-09 (The "Less CI Noise, Lighter Images, Dead-Game Detection" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Four PRs landed in this release plus a refresh of the docs and the contributor surface around the new Telegram bot. Web app + desktop app bumped from `1.0.0` → `1.1.0`. Repo public-facing version `3.0.1` → `3.1.0`. Tag `v3.1.0` is GPG-signed; companion desktop tag is `desktop-v1.1.0`.
|
||||
|
||||
## 🛠️ CI hygiene — notify wrappers (#60)
|
||||
|
||||
- The 3 notify wrappers (`notify-ci-failure`, `notify-deploy`, `notify-release-pipeline`) used to trigger on `workflow_run: workflows: ["*"]` and were filtered out by their reusable callee's `if:` — 95–100 % of runs showed as "skipped". Replaced the catch-all with explicit lists of source workflow `name:` strings per wrapper, plus job-level `if:` to short-circuit non-matching conclusions. Drops skip rate to <10 %.
|
||||
- Trade-off documented in each file: renaming a source workflow's `name:` field silently breaks notifications; comment warns about the coupling.
|
||||
|
||||
## 🖼️ Image optimisation — capsule swap + WebP via wsrv.nl (#61)
|
||||
|
||||
- `scripts/generate_tables.py:68` — markdown thumbnails now use `capsule_184x69.jpg` instead of `header.jpg` (~80 % bandwidth reduction at the same 120 px render width).
|
||||
- Web app `GamesTable` + `CommandPalette` — capsule swap with explicit `width`/`height` to eliminate CLS, plus `onError` fallback to `header.jpg` for the ~5 % of games without a capsule variant.
|
||||
- `GameDetailDrawer` — `<picture>` element with WebP source via `images.weserv.nl` proxy + JPEG fallback. Lazy-loaded, explicit dimensions.
|
||||
- `vite.config.ts` — new `CacheFirst` runtime cache for `images.weserv.nl` (`statuses: [200]` only — opaque 0-status would cache proxy errors).
|
||||
- New helper `web/src/lib/image.ts` — `headerToCapsule()` + `webpProxyUrl()`.
|
||||
|
||||
## 💀 Dead-game detection — `mark-dead-games.yml` (#62)
|
||||
|
||||
- New cron `Mon + Thu 04:30 UTC` flags **online games released >1 year ago** whose `current_players == 0` for **≥14 days** (configurable via `DEAD_GAME_DAYS` env or `--days` CLI). On trigger: `is_dead = true` + `"💀 Dead game"` appended to `notes` (idempotent).
|
||||
- **State model**: ISO timestamp `zero_player_since` (robust against schedule drift), not a streak counter.
|
||||
- **Mark mechanism**: additive `is_dead: bool` + note. `status` stays `"active"` so the existing enum / Top Online filter / chart groupings don't break. Web app gains a "Hide dead" filter toggle and a 💀 emoji prefix on dead rows.
|
||||
- **Dry-run available**: `python scripts/mark_dead_games.py --dry-run --days 0` for auditing without writes.
|
||||
- New helper `append_note_idempotent()` in `scripts/core/data_store.py`. Retrofitted onto `check_dead_links.py` to fix duplicate `"💀 Delisted"` accumulation on reruns.
|
||||
- Schema migration via `_SKELETON_TEMPLATE` only (no one-shot script). Both the Python pipeline and the React app inherit defaults via existing `migrate_record()` / `migrateRecord()` loops.
|
||||
|
||||
## 🔄 Concurrency unification
|
||||
|
||||
All data-mutating workflows now share `concurrency: { group: data-write, cancel-in-progress: false }`:
|
||||
|
||||
- `update-json`, `update-daily`, `top-online`, `update-reviews`
|
||||
- `check-dead-links`, `purge-unhealthy`, `mark-dead-games` (new)
|
||||
- `ingest-new`, `ingest-from-issue`, `bot-ingest`, `refetch-all`
|
||||
|
||||
Prevents races on `git push` to `data/` shards. Bot-ingest moved from its own `bot-ingest` group to the unified group.
|
||||
|
||||
## 📝 Docs + contributor surface (this PR)
|
||||
|
||||
- **`AUTHORS.md`** at repo root — handle map for the maintainer, AI-assistant disclosure, MIT licensing reminder.
|
||||
- **`username.txt`** extended with `telegram bot`, `telegram user`, and `email` lines (canonical machine-readable handle map mirrored by `AUTHORS.md`).
|
||||
- **`assets/qr/`** — QR-code PNGs for `@my_skull_bot` and `@SkullMute0011` (mirrored to `web/public/qr/` so the SPA can serve them). Generated via `python -m qrcode`.
|
||||
- **`web/src/pages/About.tsx`** — Maintainer card now lists Telegram bot + Telegram DM (with QR thumbnails inline) + Email. New "Telegram QR codes" card with full-size scannable codes. Privacy note about Telegram `user_id` handling.
|
||||
- **`CONTRIBUTING.md`** rewrite — adds the `@my_skull_bot` flow as a first-class contribution path (find `user_id` → DM maintainer privately → whitelist → run when bot's online → follow prompts). Loud privacy warning at the top.
|
||||
- **`docs/PRIVACY_POLICY.md`** — new "Telegram bot" section covering the `user_id` data flow, where it's stored, retention/removal, and the maintainer's commitment.
|
||||
- **`docs/ToS.md`** — new section 5.1 "Sharing personal information when contributing" with non-negotiable rules about private vs public channels.
|
||||
- **`docs/Contact.md`** — Telegram bot + DM entries added at the top.
|
||||
- **README** badges and feature list refreshed (version bumped, dead-game workflow listed, About-page QR card mentioned).
|
||||
|
||||
## 🔢 Versioning
|
||||
|
||||
| Surface | Old | New |
|
||||
|---|---|---|
|
||||
| Repo public-facing | 3.0.1 | **3.1.0** |
|
||||
| `web/package.json` | 1.0.0 | **1.1.0** |
|
||||
| `web/src-tauri/Cargo.toml` | 1.0.0 | **1.1.0** |
|
||||
| `web/src-tauri/tauri.conf.json` | 1.0.0 | **1.1.0** |
|
||||
| Git tag (signed) | `v3.0.1` | `v3.1.0` |
|
||||
| Desktop tag (signed) | `desktop-v1.0.0` | `desktop-v1.1.0` |
|
||||
@@ -0,0 +1,74 @@
|
||||
# v3.2.0 – 2026-05-11 (The "SEO + Donate + Auto-Discussion + Health Polish + Dev Docs" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Single-PR bundle (#64) shipping eight features on top of v3.1.0. Web app + desktop bumped from `1.1.0` → `1.2.0`. Repo public-facing version `3.1.0` → `3.2.0`. Tag `v3.2.0` is GPG-signed; companion desktop tag is `desktop-v1.2.0`.
|
||||
|
||||
## 🔍 SEO basics
|
||||
|
||||
- `web/index.html` — full Open Graph block (`og:type`, `og:title`, `og:description`, `og:url`, `og:image`, `og:site_name`, `og:locale` + alternate), Twitter Card (`summary`), `<link rel="canonical">`, `meta name="author"`, JSON-LD (`WebSite` + `Person` + `SoftwareApplication`).
|
||||
- New `web/public/robots.txt` (allow all + sitemap pointer) and `web/public/sitemap.xml` (5 entries: site root, GitHub repo, all-games / top-online / changelog markdown).
|
||||
- New hook `web/src/hooks/useDocumentTitle.ts` — sets `document.title` to `<page> · Steam F2P Tracker` and re-runs on language change. Wired into all 18 routes (Dashboard / Games / TopOnline / Health / Activity / Add / About / Donate / Settings / 9 charts).
|
||||
- VitePWA already emits `manifest.webmanifest` from `vite.config.ts`; no manual manifest needed.
|
||||
|
||||
## 💬 Auto-create GitHub Discussion on release
|
||||
|
||||
- New `.github/workflows/announce-release-discussion.yml` — fires on `release: published` (plus `workflow_dispatch` with a `tag` input for re-runs).
|
||||
- Implemented via `actions/github-script@v8` + GraphQL `createDiscussion` (REST has no equivalent).
|
||||
- Resolves the discussion category by slug — defaults to `Announcements`, falls back to `General` with a logged warning, then to the first available category.
|
||||
- **Idempotent**: a GraphQL search runs first; if a discussion with the same title exists, the workflow skips with `core.notice()` and returns the existing URL via output. Re-running `workflow_dispatch` is therefore a no-op.
|
||||
- Permissions: `contents: read`, `discussions: write` — both granted by `GITHUB_TOKEN` defaults once Discussions is enabled on the repo.
|
||||
|
||||
## 💖 Donate page
|
||||
|
||||
- New `web/src/pages/Donate.tsx` route at `/donate` — grid of 5 platform cards (GitHub Sponsors, Ko-fi, Buy Me a Coffee, Patreon, PayPal) sourced from `.github/FUNDING.yml`.
|
||||
- Each card has a tinted icon ring, label, short description, and an "Open" button (`target="_blank" rel="noopener noreferrer"`).
|
||||
- New nav item in `web/src/components/layout/Sidebar.tsx` SECONDARY group (between About and Settings); `Heart` icon from lucide.
|
||||
- Full EN + VI i18n keys under `donate.*` (title / subtitle / cta / footnote + per-platform label & desc).
|
||||
|
||||
## 📖 Dev docs
|
||||
|
||||
- New `docs/pc_spec.md` (EN) + `docs/i18n/vi/pc_spec.md` (VI) — maintainer hardware spec mirroring `E:\spec.txt` (CPU / GPU / RAM / IDE) plus iPhone test-device list.
|
||||
- New `docs/dev_env.md` (EN) + `docs/i18n/vi/dev_env.md` (VI) — IDE map (PyCharm / WebStorm / RustRover 2026.x), toolchain table (Python 3.12 / Node ≥ 22 / Rust stable / Tauri 2), per-area dev workflow (web / Tauri / Python pipeline), Git + GPG conventions, branch + PR flow.
|
||||
- New `web/src-tauri/TAURI.md` — desktop build prerequisites (incl. CI's exact `apt-get` line), local + production build commands, signing + auto-update notes, troubleshooting.
|
||||
- `AUTHORS.md` — new "Dev info" table (GitHub handle, IDE channel, toolchain versions, link map to all the above).
|
||||
- README "Docs" section — links the four new docs.
|
||||
|
||||
## 🤖 Telegram bot user-guide pointer
|
||||
|
||||
- New `docs/telegram-bot.md` — one-page pointer to the external [`telegram-scraper-bot/docs/USER_GUIDE.md`](https://github.com/poli0981/telegram-scraper-bot/blob/main/docs/USER_GUIDE.md), bot source repo, plus a paragraph each on what the bot does and the whitelist lifecycle.
|
||||
- `CONTRIBUTING.md` — section 3 (`@my_skull_bot`) gets a 3-line callout with the user guide link, bot source URL, and the new in-repo summary doc.
|
||||
- `web/src/pages/About.tsx` — Maintainer card's privacy note now includes a "Bot user guide & source" sub-card with the same three links.
|
||||
|
||||
## 🩺 Health bucket split
|
||||
|
||||
- `web/src/pages/Health.tsx` — `gatherIssues()` adds a fifth `IssueGroup`: `OnlineAcUnknown` for games with `type_game === "online"` and `anti_cheat ∈ {"", "-"}`. Previously these games were silently dropped from all categories; now they have a discoverable home.
|
||||
- Edge-case fix: the existing "Kernel" filter compared `(r.anti_cheat ?? "-") !== "-"`, missing the empty-string case. Both filters now use a normalised `(r.anti_cheat ?? "").trim()`.
|
||||
- `ShieldQuestion` icon (lucide). EN + VI i18n keys: `health.groupOnlineAcUnknown` + `…Desc`.
|
||||
|
||||
## 🎮 Steam Desktop direct link
|
||||
|
||||
- New helper `web/src/lib/steam-link.ts` — `steamProtocolUrl(appid)` returns `steam://store/<appid>`, `steamWebUrl(appid)` returns the regular HTTPS store URL.
|
||||
- `web/src/components/games/GameDetailDrawer.tsx` — single store link replaced by two buttons rendered side-by-side: a primary "Steam Desktop" (`steam://`) and an outline "Web" (`https://`). Tooltip on the desktop button explains the fallback path.
|
||||
- Works in both web build (browser shows protocol prompt if Steam is installed, silent fail otherwise — Web button is the safety net) and Tauri build (Tauri 2 allows `steam://` navigation by default; no allow-list change needed).
|
||||
- EN + VI i18n: `detail.openOnSteamDesktop`, `detail.openOnSteamDesktopHint`, `detail.openOnSteamWeb`.
|
||||
|
||||
## 🛌 Bi-weekly offline-player leaderboard
|
||||
|
||||
- New `scripts/top_offline.py` — clones the `top_online.py` shape but filters `_is_offline(g)` (non-empty `type_game ≠ "online"`). Emits `games/top-offline.md` (top 100 single-player F2P concurrents, 10-column format identical to top-online).
|
||||
- Calibrated tier thresholds (`_TIERS`) lower than online (offline games rarely break 6-figure concurrents) — `🔥 Mega ≥ 20k`, `⭐ Hot ≥ 5k`, `🟢 Healthy ≥ 1.5k`, `🟡 Stable ≥ 300`, `🟠 Low ≥ 50`, `🔴 Quiet ≥ 10`, `💀 Idle <10`.
|
||||
- New `bash/offline.sh` matches the shape of `bash/online.sh` (pip install requests → run script → conditional commit).
|
||||
- New `.github/workflows/top-offline.yml` — cron `0 5 1,15 * *` (1st + 15th of each month at 05:00 UTC) plus `workflow_dispatch`. Shares the unified `data-write` concurrency group.
|
||||
- Health page (`web/src/pages/Health.tsx`) — new manual trigger button "Top offline" (next to the existing "Top online" trigger).
|
||||
- **Bug fix during implementation**: `scripts/core/fetcher.py:update_players_only()` had a hardcoded `type_game == "online"` filter that would have made the offline workflow refresh zero rows. Extended with a `type_filter` kwarg (`"online"` default for backward compat, `"offline"`, or `"all"`); `top_offline.py` passes `type_filter="offline"` (excludes both online and empty/unclassified type).
|
||||
|
||||
## 🔢 Versioning
|
||||
|
||||
| Surface | Old | New |
|
||||
|---|---|---|
|
||||
| Repo public-facing | 3.1.0 | **3.2.0** |
|
||||
| `web/package.json` | 1.1.0 | **1.2.0** |
|
||||
| `web/src-tauri/Cargo.toml` | 1.1.0 | **1.2.0** |
|
||||
| `web/src-tauri/tauri.conf.json` | 1.1.0 | **1.2.0** |
|
||||
| Git tag (signed) | `v3.1.0` | `v3.2.0` |
|
||||
| Desktop tag (signed) | `desktop-v1.1.0` | `desktop-v1.2.0` |
|
||||
@@ -0,0 +1,20 @@
|
||||
# v3.2.1 – 2026-05-11 (The "Genre Cleanup" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Patch release on top of v3.2.0. Normalizes inconsistent `genre` values across the dataset (31 records, 10 canonical mappings) and broadens the webapp's genre combobox with 14 additional suggestions. Web app + desktop bumped `1.2.0` → `1.2.1`. Repo public-facing version `3.2.0` → `3.2.1`. Tag `v3.2.1` is GPG-signed; companion desktop tag is `desktop-v1.2.1`.
|
||||
|
||||
## 🧹 Genre normalization script
|
||||
|
||||
- New `scripts/normalize_genres.py` — local one-shot tool with `--apply` flag (dry-run by default). Reuses `core.data_store.load_main` / `save_main` so writes are atomic + sharded.
|
||||
- Canonical mappings applied (sentence-case style for compounds): `Hack and Slash` → `Hack & Slash` (4), `Third-Person Shooter` → `Third-person Shooter` (7), `Top-Down Shooter` → `Top-down Shooter` (3), `Turn-Based Strategy` → `Turn-based Strategy` (3), `Turn-Based Tactics` → `Turn-based Tactics` (4), `Turn-Based Combat` → `Turn-based Combat` (2), `Shoot 'Em Up` / `Shoot'em up` → `Shoot 'em up` (5), `Point-and-Click` → `Point & Click` (1), `Rougelite` → `Roguelite` (2 typo).
|
||||
- 31 records updated · 10 unique canonical changes · unique-genre count 100 → 92.
|
||||
- Idempotent — second run reports "data already canonical".
|
||||
- Comma-separated values like `"Action RPG, Gacha"` (Wuthering Waves, Honkai Impact 3rd) are flagged in a "Manual review needed" section rather than auto-split, since the schema is single-genre.
|
||||
- All `games/*.md` regenerated via `scripts/generate_tables.py`; affected genre files include the new sentence-case slugs (`turn-based-strategy.md`, `top-down-shooter.md`, `third-person-shooter.md`, `roguelite.md`, etc.).
|
||||
|
||||
## 🎛 Webapp genre dropdown additions
|
||||
|
||||
- `web/src/lib/enums.ts` — `GENRE_ENUM` extended from 44 → 58 entries. Added 14 sub-genres already common in the data: `Action RPG`, `Beat 'em up`, `Bullet Hell`, `Clicker`, `Hidden Object`, `Real-Time Strategy`, `Roguelite`, `Survival Horror`, `Tactical RPG`, `Third-person Shooter`, `Top-down Shooter`, `Turn-based RPG`, `Turn-based Strategy`, `Turn-based Tactics`.
|
||||
- Sentence-case style matches the normalized data values.
|
||||
- Dropdown filter on `web/src/pages/Games.tsx` is facet-driven (auto-updates from the records), so it now shows the deduplicated canonical names. The `EditGameDrawer` combobox suggests the 14 new entries while still accepting free-text input.
|
||||
@@ -0,0 +1,28 @@
|
||||
# v3.2.2 – 2026-05-11 (The "Bug Fix Quartet" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Patch release on top of v3.2.1. Four user-reported bug fixes touching the Ctrl+K command palette on desktop, the Health → Games navigation flow, Tauri process-stacking on every launch, and the `type_game` scraper that was defaulting every new game to `"offline"`. Web app + desktop bumped `1.2.1` → `1.2.2`. Repo public-facing version `3.2.1` → `3.2.2`. Tag `v3.2.2` is GPG-signed; companion desktop tag is `desktop-v1.2.2`.
|
||||
|
||||
## 🔗 Desktop Ctrl+K external link
|
||||
|
||||
- New `web/src/lib/external-open.ts` — lazy-detects the Tauri runtime via `__TAURI_INTERNALS__`, opens external URLs through `@tauri-apps/plugin-shell` on desktop (capability `shell:allow-open` already granted in `web/src-tauri/capabilities/default.json`), falls back to `window.open(url, "_blank", "noopener,noreferrer")` on web/PWA. Plugin module is lazy-imported, so the web bundle never pays for the Tauri code path.
|
||||
- `web/src/components/common/CommandPalette.tsx` — Ctrl+K game results now route through `openExternal()`. The Tauri webview was silently blocking the raw `window.open(r.link, "_blank")` for external HTTPS URLs, so clicking a search result on desktop did nothing.
|
||||
- Six other `window.open(...)` call sites (Health workflow link, Add, BulkActionBar, BulkEditDrawer, EditGameDrawer, DeviceFlowPanel) are flagged for follow-up migration to `openExternal()` — same desktop silent-fail will hit them when triggered.
|
||||
|
||||
## 🩺 Health → Games filter restoration
|
||||
|
||||
- `web/src/pages/Games.tsx` — adds `useSearchParams` + a `useEffect` that mirrors the URL `?search=` parameter into `useFilters.search` on mount. The Health page already linked rows to `#/games?search=<name>`, but Games never read the param, so the table stayed unfiltered and the Topbar input stayed empty. The store binding to Topbar means visual feedback is automatic once the filter is set.
|
||||
- Guard `if (term !== null)` (instead of `if (term)`) lets `?search=` explicitly clear the filter — useful for shareable "no filter" links.
|
||||
|
||||
## 🪟 Tauri single-instance enforcement
|
||||
|
||||
- `web/src-tauri/Cargo.toml` — adds `tauri-plugin-single-instance = "2"` under the existing desktop-only `cfg(not(any(target_os = "android", target_os = "ios")))` block, matching the updater plugin's gating pattern.
|
||||
- `web/src-tauri/src/lib.rs` — registers single-instance as the **first** plugin so it short-circuits duplicate launches before any other state initialises. The dup-launch callback calls `unminimize()` + `show()` + `set_focus()` on the existing `main` window. Without this, every Start-menu / shortcut / file-association invocation spawned a fresh `f2p-tracker.exe` that lingered in Task Manager.
|
||||
- No capability changes needed — plugin runs entirely Rust-side, no frontend command exposed.
|
||||
|
||||
## 🎮 `type_game` online inference
|
||||
|
||||
- `scripts/core/fetcher.py` — new `_infer_type_game(categories)` reads `data.get("categories", [])` and returns `"online"` when any description contains `online`, `mmo`, `massively multiplayer`, `cross-platform multiplayer`, or `multi-player`. Pure `shared/split screen` descriptions are treated as local-only and skipped unless paired with another online signal.
|
||||
- Wired into `apply_details()` next to the existing anti-cheat category loop, guarded by `is_empty(game.get("type_game"))` so manual prefills in `temp_info.jsonl` remain authoritative — the `MANUAL_FIELDS` merge in `data_store.merge_extension_data()` and the override re-apply in `ingest_new.py` are unchanged.
|
||||
- The legacy default-to-`"offline"` at the end of `fetch_full()` stays as the final safety net for games with no multiplayer signal in Steam categories. New ingests of online F2P games now classify correctly instead of all-offline.
|
||||
@@ -0,0 +1,26 @@
|
||||
# v3.2.3 – 2026-05-17 (The "View Commit Toast + Offline AC Lock" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Patch release on top of v3.2.2. Three user-reported fixes: the "View commit" action button in success toasts (now reachable + cross-platform), an editor lock that prevents anti-cheat fields from being set on offline games, and a broken `Mark dead games` workflow setup-python step. Web app + desktop bumped `1.2.2` → `1.2.3`. Repo public-facing version `3.2.2` → `3.2.3`. Tag `v3.2.3` is GPG-signed; companion desktop tag is `desktop-v1.2.3`.
|
||||
|
||||
## 🍞 View commit toast — clickable + desktop-safe
|
||||
|
||||
- Migrated the eight `window.open(commit.htmlUrl, "_blank")` action handlers in `EditGameDrawer.tsx` (2), `Add.tsx` (2 inside `reportToast`), `BulkEditDrawer.tsx` (2), and `BulkActionBar.tsx` (2) to `openExternal()` from `web/src/lib/external-open.ts` — completes the follow-up migration flagged in v3.2.2's CHANGELOG. The Tauri webview was silently blocking the raw `window.open(...)` for external HTTPS URLs, so "View commit" did nothing on desktop.
|
||||
- Each `toast.success(...)` with a "View commit" action now sets `duration: 15000` (was Sonner's 4 s default). On web the old toasts auto-dismissed before the user could read the description + click the action button.
|
||||
- Handler now accepts the click event and calls `event.preventDefault()` so the toast stays visible after click (Sonner's default is to dismiss on action click — undesirable when the user wants to glance at the SHA after opening the commit).
|
||||
- The fix applies to both the initial `toast.success` and the follow-up emit fired by `pollCommitVerification(...).then(...)` (same toast `id`, so `duration` must be set on the update too — otherwise the second emit rebounds to the 4 s default).
|
||||
|
||||
## 🔒 Anti-cheat fields lock on offline games
|
||||
|
||||
- `web/src/components/games/EditGameDrawer.tsx` — `FormFields` derives `lockAC = form.type_game === "offline"` and threads `disabled={lockAC}` to the AC `<select>`, the custom-AC `<Input>`, the three kernel `<Button>`s, and the AC note `<Textarea>`. A muted hint is rendered under the AC note when locked, explaining how to re-enable.
|
||||
- `update()` setter now auto-resets `anti_cheat=""`, `anti_cheat_note=""`, `is_kernel_ac="unknown"` when `key === "type_game" && value === "offline"`. This keeps the `formToPatch()` diff honest — switching an online game with AC populated to offline now produces an explicit AC-clear in the commit instead of orphan anti-cheat data on an offline record.
|
||||
- `web/src/pages/Add.tsx` — same pattern in `OverrideFields` + the `SingleAdd.setOv()` setter. `OverrideFields` combines the existing busy-state `disabled` prop with the new lock via `acDisabled = disabled || lockAC`, so the global "form is submitting" disable still wins. BulkAdd uses raw text / JSON input, so no UI lock needed there.
|
||||
- `type_game === ""` (unknown) deliberately does **not** lock — only an explicit `"offline"` triggers the gate. The existing `validation.ts` "kernel?" badge rule for online + missing-kernel is untouched.
|
||||
- New i18n key `edit.acLockedOffline` added to `web/src/i18n/locales/en.json` and `vi.json`, rendered as a `text-xs text-muted-foreground` hint under the AC note when `lockAC` is true.
|
||||
|
||||
## 🪦 `Mark dead games` workflow path fix
|
||||
|
||||
- `.github/workflows/mark-dead-games.yml` — `cache-dependency-path: scripts/requirements.txt` and the subsequent `pip install -r scripts/requirements.txt` both pointed at a path that doesn't exist. The file lives at the repo root (`requirements.txt`), consistent with the path `codeql.yml:25` already uses.
|
||||
- Fix: both lines now reference `requirements.txt` at the root. The `setup-python` cache lookup no longer errors with `No file in /home/runner/work/free-steam-games-list/free-steam-games-list matched to [scripts/requirements.txt or **/pyproject.toml]`, and the install step actually finds the deps.
|
||||
- Workflow is scheduled Mon + Thu 04:30 UTC; the next scheduled run will be the first end-to-end verification, but `workflow_dispatch` with `dry_run=true` is also available for ad-hoc validation.
|
||||
@@ -0,0 +1,63 @@
|
||||
# v3.2.4 – 2026-05-20 (The "Refactor + Removed-Games + Anti-Cheat Index" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Patch release on top of v3.2.3, landed as two PRs. **PR #74 (cleanup):** two dead scripts removed, `EditGameDrawer.tsx` (718 LOC) and `GamesTable.tsx` (568 LOC) split into focused sub-modules, two new charts (`TopOfflineBar`, `AddedPerMonthBar`) wired to a fresh `/top-offline` page and the existing `/charts/time` page. **PR #75 (features):** the `scripts/removed_games.jsonl` log now passes through a `dedup_removed()` filter on every write (a one-time migration trimmed 6 historical duplicates), Top Online leaderboard expanded `50 → 100` to match Top Offline, a generated `games/anti-cheat-list.md` plus a `/charts/anti-cheat/list` web page group active games by anti-cheat family, and a new `/charts/delisted` page renders a timeline + reason breakdown of every removed-from-catalogue title. Web app + desktop bumped `1.2.3` → `1.2.4`. Repo public-facing version `3.2.3` → `3.2.4`. Tag `v3.2.4` is GPG-signed; companion desktop tag is `desktop-v1.2.4`.
|
||||
|
||||
## 🧹 Dead-script removal
|
||||
|
||||
- `scripts/discord_notify.py` deleted — superseded by the `poli0981/.github` reusable workflow; no `.github/workflows/*.yml` or `bash/*.sh` referenced it.
|
||||
- `scripts/migrate_to_shards.py` deleted — one-shot v2.2 migration tool, completed and unreferenced. The 10-script "unreferenced in workflows" audit confirmed the other eight (`check_dead_links`, `delete_game`, `normalize_genres`, `purge_unhealthy`, `top_offline`, `top_online`, `update_data`, `update_reviews`) all have live `bash/*.sh` wrappers and stay.
|
||||
|
||||
## 🪓 Component splits
|
||||
|
||||
- `web/src/components/games/EditGameDrawer.tsx` (718 LOC) → 7 focused files under `edit/`:
|
||||
- `EditGameDrawer.tsx` keeps the save handler, dialog shell, view-toggle wiring.
|
||||
- `EditFormFields.tsx`, `EditJsonView.tsx` (with `JsonDiff`), `EditChangePreview.tsx`, `ViewToggle.tsx` extract the four UI regions.
|
||||
- `form-utils.ts` exports `gameToForm` + `formToPatch`; `types.ts` re-exports the `FormState` + `View` types.
|
||||
- `web/src/components/games/GamesTable.tsx` (568 LOC) → container + 5 files under `table/`:
|
||||
- `GamesTable.tsx` keeps the virtualizer (`useVirtualizer` ownership at container level so row-height stays single-source), filters, fuzzy search, sort, and paging.
|
||||
- `columns.tsx` extracts the `COLS: ColDef[]` array (12 columns) + `TOTAL_WIDTH` + `SELECT_COL_WIDTH` constants.
|
||||
- `TableHeader.tsx`, `TableRow.tsx` (memoised with `React.memo`), `TableToolbar.tsx`, `ExportMenu.tsx` extract the visual regions.
|
||||
- No behaviour change — same virtual scrolling, same sort/filter wiring, same selection store.
|
||||
|
||||
## 📊 New charts
|
||||
|
||||
- `web/src/components/charts/TopOfflineBar.tsx` — mirror of `TopOnlineBar` but with offline-tier thresholds (20k/1.5k/300) calibrated to the `top_offline.py` scale instead of the online-only 100k/10k/1k palette. Filters `type_game !== "online" && status === "active"`, top 100 by `current_players`.
|
||||
- `web/src/pages/TopOffline.tsx` — new page at `/top-offline`, layout mirror of `TopOnlinePage`, registered in `App.tsx` and `Sidebar.tsx` (Trophy icon).
|
||||
- `web/src/components/charts/AddedPerMonthBar.tsx` — aggregates `records[*].added_at` into `YYYY-MM` buckets, renders an ECharts bar. Added as a third card to the existing `charts/Time.tsx` page alongside `ReleaseYearHistogram` + `AddedCumulativeLine`.
|
||||
|
||||
## 🗑️ Removed-games dedup
|
||||
|
||||
- `scripts/core/data_store.py` — new `dedup_removed(records)` keeps the latest entry per appid (compared by `removed_at` ISO timestamp, lexicographic order matches chronological for `YYYY-MM-DDTHH:MM:SSZ`). Records without a resolvable appid are dropped.
|
||||
- `scripts/purge_unhealthy.py:41-43` and `scripts/ingest_new.py:106-108` — both call sites now write `dedup_removed(existing + log)` instead of `existing.extend(log)`. Same `save_jsonl` atomic-rename transaction, so partial writes can't leave duplicates.
|
||||
- `scripts/dedup_removed_games.py` (new) — one-shot CLI that loads, dedups, and rewrites the file. Run once locally as part of this release; idempotent, safe to re-run.
|
||||
- Result: existing log trimmed `43 → 37` records. Verified zero duplicate appids post-migration.
|
||||
|
||||
## 🏆 Top Online expanded 50 → 100
|
||||
|
||||
- `scripts/core/constants.py:81` — `TOP_ONLINE_LIMIT = 100` (was 50). Top Offline already 100.
|
||||
- `games/top-online.md` regenerated with 100 rows on next workflow tick; format unchanged (10-column table preserved).
|
||||
- `web/src/pages/TopOnline.tsx` — `<TopOnlineBar limit={100} height={1800}>` to match the new row count.
|
||||
- i18n strings `topOnline.{subtitle,cardTitle}` updated `Top 50 → Top 100` in both `en.json` and `vi.json`.
|
||||
|
||||
## 🛡️ Anti-cheat list
|
||||
|
||||
- `scripts/generate_anti_cheat_list.py` (new) — buckets active games by canonical AC name (`ANTI_CHEAT_PATTERNS` keys), with substring-match fallback for free-text values. Unrecognised values land in an `Other` bucket with a stderr warning. Output `games/anti-cheat-list.md`: H1 + TOC + per-family H2 sections, each a 6-column table sorted by `current_players` desc.
|
||||
- `bash/anti_cheat.sh` + `.github/workflows/anti-cheat-list.yml` (new) — weekly Sunday 06:00 UTC cron + manual dispatch. Uses the same `data-write` concurrency group as the other table-generation workflows.
|
||||
- `web/src/pages/AntiCheatList.tsx` (new) — `/charts/anti-cheat/list` page mirrors the MD: collapsible per-family sections + sticky AC-name sidebar nav. Uses existing `useGames` hook; canonicalises client-side via a TS port of the Python patterns table. i18n keys `antiCheatList.*` added to en + vi.
|
||||
|
||||
## 📉 Delisted charts
|
||||
|
||||
- `web/src/hooks/useRemovedGames.ts` (new) — fetches `scripts/removed_games.jsonl` from raw.githubusercontent.com, parses lines, deduplicates client-side (same logic as the Python dedup). TanStack Query with 5-minute staleTime.
|
||||
- `web/src/components/charts/DelistedTimeline.tsx` (new) — ECharts stacked bar, x = `YYYY-MM` of `removed_at`, stacked by `status_code` (`not_free` / `unavailable` / fallback `other`).
|
||||
- `web/src/components/charts/DelistedReasonBreakdown.tsx` (new) — ECharts donut by `status_code`.
|
||||
- `web/src/pages/charts/Delisted.tsx` (new) — `/charts/delisted` page renders both charts. Sidebar nav link with `WifiOff` icon.
|
||||
- `web/src/components/charts/KpiCards.tsx` — new optional `removedCount` prop; when set, renders a 7th "Removed (all-time)" KPI alongside the existing in-catalog "Delisted" badge. Wired from `Dashboard.tsx` via `useRemovedGames().data?.length`. Grid bumps from `xl:grid-cols-6` to `xl:grid-cols-7`.
|
||||
|
||||
## 📝 Docs
|
||||
|
||||
- README: removed the duplicate "Quick Links" section (the comprehensive 11-row "Quick links" table at the top covers everything the 4-row duplicate listed).
|
||||
- README: added `🎯 Top offline (md)` row to the main Quick links table.
|
||||
- README: version badge bumped `3.2.3` → `3.2.4`.
|
||||
- i18n: combined `nav.{topOffline,antiCheatList,delisted}`, `topOffline.*`, `antiCheatList.*`, `charts.{time.addedPerMonth,delisted.*}` keys added to `en.json` + `vi.json`.
|
||||
@@ -0,0 +1,30 @@
|
||||
# v3.2.5 – 2026-05-20 (The "AC Nav + Mobile + Games Cleanup" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Patch release on top of v3.2.4. One reported bug fix + three quality-of-life polish items. **Bug:** clicking any "Family" link in the Anti-Cheat Index sidebar redirected to the Dashboard instead of scrolling to the matching family table — `HashRouter` was treating the `<a href="#vac">` anchor as a route navigation. **Polish:** the `GamesTable` (1318 px wide) now degrades to a virtualised card list below the `md` breakpoint so mobile no longer needs horizontal scroll; the `AntiCheatList` sidebar drops to `md` instead of `lg` and exposes a horizontal chip nav on phones; `KpiCards` adds `md`/`lg` rungs to avoid uneven grid jumps. **Cleanup:** 93 per-genre markdown files in `games/` are removed (the web app's `/games?genre=X` filter has replaced them since v3.0); `generate_tables.py` now skips regeneration when game data hasn't actually changed via a `.gen-hash` checksum, cutting daily catalogue commits to roughly the days that move records. **New:** floating back-to-top button on the main scroll container, fades in past 400 px. Web app + desktop bumped `1.2.4` → `1.2.5`. Repo public-facing version `3.2.4` → `3.2.5`. Tag `v3.2.5` is GPG-signed; companion desktop tag is `desktop-v1.2.5`.
|
||||
|
||||
## 🔗 AC Index sidebar navigation fix
|
||||
|
||||
- [web/src/pages/AntiCheatList.tsx](../../../web/src/pages/AntiCheatList.tsx): swap `<a href="#anchor">` for `<button onClick>` that calls `document.getElementById(id).scrollIntoView({ behavior: "smooth", block: "start" })`. The `id={anchor}` attribute on each family `<Card>` stays the same — only the click target changes.
|
||||
- Root cause: `main.tsx:24` uses `HashRouter`. Anchor links inside a hash-routed page produce URLs like `#/charts/anti-cheat/list#vac`. HashRouter parses the trailing `#vac` as a fresh route, the regex doesn't match, and the `<Route path="*" element={<Navigate to="/" replace />}>` fallback in `App.tsx` sends the user to the Dashboard.
|
||||
- Same fix applied to the new mobile chip nav (below) so behaviour is uniform across viewports.
|
||||
|
||||
## 📱 Mobile responsive
|
||||
|
||||
- New `web/src/components/games/table/MobileGameCards.tsx` — virtualised card list rendering one card per game with thumb, name, genre/type/AC/status badges, review %, current players, and a Steam-link icon. Shares filter/sort/page state with the desktop table via the existing `useFilters` store.
|
||||
- [`GamesTable.tsx`](../../../web/src/components/games/GamesTable.tsx) wraps the desktop scroll container in `hidden md:block` and renders `<MobileGameCards>` inside `md:hidden`. No new state, no behaviour drift between views.
|
||||
- [`AntiCheatList.tsx`](../../../web/src/pages/AntiCheatList.tsx) sidebar changes from `hidden w-48 shrink-0 lg:block` to `hidden md:block md:w-40 lg:w-48` — visible on tablets too. Below `md`, a horizontal scrollable chip rail above the content provides the same family-jump nav.
|
||||
- [`KpiCards.tsx`](../../../web/src/components/charts/KpiCards.tsx) grid `sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-7` → `sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-7`. Inserts `md` (tablet, 3 cols) and `lg` (small laptop, 4 cols) rungs so the 7 KPIs don't double-stack awkwardly.
|
||||
|
||||
## 🧹 `games/` cleanup + smart regen
|
||||
|
||||
- **Deleted 93 per-genre `<genre>.md` files** (`action.md`, `fps.md`, `visual-novel.md`, …). Web app `/games?genre=X` is the canonical genre filter since v3.0; no inbound link audit hit anything beyond `games/README.md` (regenerated) and the now-stale "By Genre" section in the index. Files kept: 11 × `all-games_part*.md`, `top-online.md`, `top-offline.md`, `anti-cheat-list.md`, `README.md`.
|
||||
- [`scripts/generate_tables.py`](../../../scripts/generate_tables.py) drops the genre loop entirely and rewrites the `games/README.md` template to point at part files + leaderboards + AC list, with a one-line note about the web-app genre filter.
|
||||
- **Smart regen via `.gen-hash`** — script computes `sha256` of sorted `(link, name, genre, reviews, current_players, anti_cheat, is_kernel_ac, status)` tuples and writes the digest to `games/.gen-hash`. Subsequent runs short-circuit (`Skip: no semantic changes (hash=...)`) when the hash is unchanged. Order-invariant, ignores timestamps embedded in MD output, so daily workflow ticks only commit when game data actually moves.
|
||||
|
||||
## ⬆️ Back-to-top button
|
||||
|
||||
- New `web/src/components/common/BackToTop.tsx` — a fixed-position icon button bottom-right of the viewport. Listens for `scroll` events on the passed scroll container ref (passive listener), fades in (`opacity-100`) past 400 px, becomes pointer-events-none below to avoid blocking click-through.
|
||||
- [`Layout.tsx`](../../../web/src/components/layout/Layout.tsx) creates a `useRef<HTMLElement>` on `<main>`, passes it as `scrollRef`. Single mount, no per-page wiring.
|
||||
- i18n: `common.backToTop` added to `en.json` ("Back to top") and `vi.json` ("Lên đầu trang") for `aria-label` + `title`.
|
||||
@@ -0,0 +1,16 @@
|
||||
# v3.2.6 – 2026-05-20 (The "Mobile Hotfix" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Hotfix on top of v3.2.5. Two mobile-viewport regressions introduced by the v3.2.5 responsive overhaul. Web app + desktop bumped `1.2.5` → `1.2.6`. Repo public-facing version `3.2.5` → `3.2.6`. Tag `v3.2.6` is GPG-signed; companion desktop tag is `desktop-v1.2.6`.
|
||||
|
||||
## 🐛 AC Index table — horizontal scroll on mobile
|
||||
|
||||
- `web/src/pages/AntiCheatList.tsx` — the per-family table wrapper was `<div className="overflow-hidden rounded-md border">`. On a 390 px viewport the 5-column table (`# / Game / Genre / Kernel / Players`) is wider than the card, and `overflow-hidden` clipped the right-hand columns with no way to scroll to them.
|
||||
- Fix: `overflow-hidden` → `overflow-x-auto`. The table now scrolls horizontally when it exceeds the viewport, and the scrollbar stays hidden when it fits.
|
||||
|
||||
## 🖼️ Mobile game cards — thumbnail fallback
|
||||
|
||||
- `web/src/components/games/table/MobileGameCards.tsx` — the card `<img>` loads `headerToCapsule(g.header_image)` (the smaller `capsule_184x69.jpg` variant, ~10 KB vs ~50 KB). Steam's CDN doesn't host that variant for every game, so those cards rendered a blank thumbnail.
|
||||
- The desktop table column (`table/columns.tsx`) already had an `onError` handler that falls back to the original `header.jpg`; the v3.2.5 mobile card component didn't port it. `GameDetailDrawer` uses `g.header_image` directly, which is why the image always appeared once a card was tapped.
|
||||
- Fix: add the same `onError` fallback to the mobile card `<img>` — on a 404 it swaps `src` to `g.header_image`, with an `el.src !== g.header_image` guard against an infinite error loop.
|
||||
@@ -0,0 +1,35 @@
|
||||
# v3.2.7 – 2026-05-22 (The "Coming-Soon Guard + Dead-Code Cleanup" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Maintenance release on top of v3.2.6. A small, useful batch: the Python pipeline now rejects unreleased ("coming soon") games at ingest instead of listing titles nobody can play yet; a one-time dead-code sweep across the web app and the pipeline; and three dev-tooling additions (knip, vulture, pip-audit) so future releases can run the same checks. Web app + desktop bumped `1.2.6` → `1.2.7`. Repo public-facing version `3.2.6` → `3.2.7`. Tag `v3.2.7` is GPG-signed; companion desktop tag is `desktop-v1.2.7`.
|
||||
|
||||
## 🚧 Coming-soon games rejected at ingest
|
||||
|
||||
- `scripts/core/health_checker.py` — new `COMING_SOON` status, added to the `REMOVABLE` set. `check_game_health()` now reads the Steam `appdetails` flag `release_date.coming_soon` right after the API response resolves (before the `is_free` check) and returns `HealthResult(COMING_SOON, …)` for unreleased titles.
|
||||
- Effect: `ingest_new.py` rejects coming-soon entries from the queue and logs them to `removed_games.jsonl` with reason "Not yet released (coming soon)" — the same path `NOT_FREE` already uses. `purge_unhealthy.py`'s weekly scan likewise evicts any coming-soon title already in the dataset.
|
||||
- Rationale: an F2P *games* tracker should list playable titles. A coming-soon game has zero players, no reviews, and an unconfirmed price (it can launch paid). The API flag is used instead of scraping the `game_area_comingsoon` HTML block — it's already fetched during the health check and is authoritative. No schema change.
|
||||
|
||||
## 🧹 Web dead-code cleanup (knip)
|
||||
|
||||
- New `knip` sweep (config in `web/knip.json`). Removed two unused files: `src/components/common/UpdateChecker.tsx` — the Tauri auto-update component, never wired into `Layout.tsx` since Phase 9, so the frontend update check never actually ran — and `src/components/ui/switch.tsx`, an unused shadcn primitive.
|
||||
- Removed 11 unused dependencies from `web/package.json`: 7 Radix primitives (`react-dropdown-menu`, `react-scroll-area`, `react-select`, `react-switch`, `react-tabs`, `react-toast`, `react-tooltip`), `@tanstack/react-table` (the virtualised table uses only `@tanstack/react-virtual`), and 3 Tauri packages (`@tauri-apps/api`, `@tauri-apps/plugin-process`, `@tauri-apps/plugin-updater` — the last two were referenced only by the removed `UpdateChecker`).
|
||||
- `vite.config.ts` — dropped the now-stale `@tanstack/react-table` entry from the `manualChunks.table` group.
|
||||
- knip's remaining "unused export" findings inside the `src/lib/*` port modules are intentional API surface; they're set to `warn` so `npm run knip` stays green.
|
||||
|
||||
## 🧹 Python dead-code cleanup (vulture)
|
||||
|
||||
- Deleted `scripts/dedup_removed_games.py` — the one-shot v3.2.4 migration, completed and now redundant (`dedup_removed()` runs inside the pipeline on every write). Same rationale as v3.2.4's removal of `migrate_to_shards.py`.
|
||||
- `scripts/core/data_store.py` — dropped the unused `EXTENSION_FIELDS` import. The constant stays defined in `constants.py` as the documented MANUAL/ARRAY/EXTENSION field-class trio (mirrored in `web/src/lib/schema.ts`).
|
||||
- `scripts/core/steam_client.py` — `__exit__(self, *a)` → `__exit__(self, *_)` (idiomatic unused-varargs name).
|
||||
|
||||
## 🧰 Dead-code & audit tooling
|
||||
|
||||
- **knip** — `web/package.json` devDependency + `npm run knip` script + `web/knip.json`. Finds unused files / exports / dependencies in the TypeScript SPA.
|
||||
- **vulture** + **pip-audit** — new `requirements-dev.txt`; vulture config in a new root `pyproject.toml` (`[tool.vulture]`, `min_confidence = 80`). Python dead-code detection + dependency CVE audit.
|
||||
- All three run at dev time only — nothing new ships in the pipeline, web bundle, or desktop app.
|
||||
|
||||
## 📄 Docs
|
||||
|
||||
- New `docs/THIRD_PARTY.md` — documents the dev tooling above (purpose, license, where declared) and the canonical pre-publish check suite. Linked from the README "Docs" section.
|
||||
- Synced the third-party dependency lists to the removals above — `docs/ACKNOWLEDGEMENTs.md`, the in-app `/about` page (`web/src/pages/About.tsx`), and `web/README.md` no longer list the dropped Radix primitives, `@tanstack/react-table`, or `@tauri-apps/api`.
|
||||
@@ -0,0 +1,46 @@
|
||||
# v3.3.0 – 2026-06-12 (The "Lazy-Load + Error Pages" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Feature release on top of v3.2.7, two themes: a web-app performance overhaul (route-level code splitting, lazy echarts/openpgp/locale chunks — first-load JS drops from ~574 KB to ~163 KB gzipped, −72%) and a proper error-page system (403/404/419/5xx/offline pages, React error boundaries, a real GitHub Pages `404.html`). Web app + desktop bumped `1.2.7` → `1.3.0`. Repo public-facing version `3.2.7` → `3.3.0`. Tag `v3.3.0` is GPG-signed; companion desktop tag is `desktop-v1.3.0`.
|
||||
|
||||
## ⚡ Lazy-loading overhaul
|
||||
|
||||
- **Route splitting** — [web/src/App.tsx](../../../web/src/App.tsx): every page except `Dashboard` (the landing route) is now `React.lazy` via a new `lazyWithRetry` helper ([web/src/lib/lazy.ts](../../../web/src/lib/lazy.ts)). The `<Suspense>` boundary sits inside [Layout.tsx](../../../web/src/components/layout/Layout.tsx) around `<Outlet/>`, so the sidebar/topbar stay mounted during navigation; fallback reuses the existing `LoadingState`.
|
||||
- **echarts (~666 KB raw)** — new [LazyEChart.tsx](../../../web/src/components/charts/LazyEChart.tsx) wrapper is the single dynamic boundary for `EChart.tsx` (which keeps the `echarts.use([...])` registration). All 15 chart components swap one import line; a fixed-height `animate-pulse` skeleton prevents layout shift. echarts now downloads only when a chart mounts.
|
||||
- **openpgp (~391 KB raw)** — [web/src/lib/gpg.ts](../../../web/src/lib/gpg.ts) switches to a type-only import + memoized `await import("openpgp")`. All exports were already async, so zero caller changes; visitors without a saved GPG key never download the crypto chunk at all.
|
||||
- **Per-locale i18n** — [web/src/i18n/index.ts](../../../web/src/i18n/index.ts): `en.json` stays bundled (it's `fallbackLng` — a missing key can never render raw), `vi.json` becomes a dynamic import. `initI18n()` preloads the detected locale before `i18n.init`, and [main.tsx](../../../web/src/main.tsx) awaits it before first render — no flash of raw keys, verified with a hard reload under `f2p:lang=vi`. `setLanguage()` is now async and loads the bundle *before* switching. Also syncs `<html lang>` (was hardcoded `vi` for everyone).
|
||||
- **manualChunks fix** — forcing `echarts`/`openpgp` into `manualChunks` made Rollup hoist shared helpers (tslib) *into* the echarts chunk, which the eager graph then statically imported — echarts was being modulepreloaded on first paint, nullifying the lazy boundary. Both entries are removed from [vite.config.ts](../../../web/vite.config.ts); the dynamic-import boundaries split them naturally. `dist/index.html` now modulepreloads only `react` + `query`.
|
||||
- Net effect: eager JS `~1746 KB → ~494 KB` raw (`~574 → ~163 KB` gzip). The PWA still precaches everything in the background, but first paint no longer waits for charts + crypto.
|
||||
|
||||
## 🚦 Error pages (403 / 404 / 419 / 500 / 502 / 503 / 504 / offline)
|
||||
|
||||
- New [web/src/pages/errors/ErrorPage.tsx](../../../web/src/pages/errors/ErrorPage.tsx) — one config-driven component: per-code lucide icon + tone (neutral/warn/destructive, reusing the exact `ErrorState`/`PwaIndicator` palettes), mono `ERROR {{code}}` badge, i18n'd title/description, and three actions (Go home / Reload / Report issue → GitHub Issues). Full `errors.*` key blocks added to both [en.json](../../../web/src/i18n/locales/en.json) and [vi.json](../../../web/src/i18n/locales/vi.json). Kept in the eager bundle on purpose — error UI must not live in a lazy chunk.
|
||||
- Routing — `#/error/:code` deep links via `ErrorCodeRoute` (unknown codes render 404 in place, no redirect), and the catch-all `<Route path="*">` now shows a real 404 page instead of silently redirecting to the Dashboard.
|
||||
- **GitHub Pages `404.html`** — new [web/public/404.html](../../../web/public/404.html): standalone dark page (inline CSS, no JS deps), bilingual via a one-liner that respects the app's own `f2p:lang`, `noindex`, absolute link back to `/free-steam-games-list/#/`. Excluded from the SW precache via `globIgnores` in [vite.config.ts](../../../web/vite.config.ts) — SW-controlled clients get `navigateFallback` and never see it.
|
||||
|
||||
## 🛡️ Error boundaries + stale-deploy resilience
|
||||
|
||||
- New [ErrorBoundary.tsx](../../../web/src/components/common/ErrorBoundary.tsx) (own ~40-line class, no new dep) with a `resetKey` prop — navigating away clears a stuck error *without* remounting the page subtree on every navigation (which `key` would do, destroying table scroll/selection state).
|
||||
- Two mounts: route-level inside `Layout` (chunk-load error → 503 page with "new version deployed, reload" copy; render crash → 500 page, error message shown in dev only), and a top-level [AppErrorBoundary](../../../web/src/components/common/AppErrorBoundary.tsx) outside the router with inline styles + hardcoded bilingual strings — immune to i18n/Tailwind/router failures.
|
||||
- `lazyWithRetry` handles the deploy-mid-session case: a chunk 404 triggers ONE auto-reload per tab (`sessionStorage` flag, try/catch-guarded for lockdown webviews) which also picks up the waiting service worker; a second failure throws to the boundary.
|
||||
|
||||
## 🔌 Real error flows wired in
|
||||
|
||||
- [QueryState.tsx](../../../web/src/components/common/QueryState.tsx) `ErrorState` upgraded in place (contract preserved): offline detection swaps in the `errors.offline.*` copy + `WifiOff` icon, plus Retry / Report-issue action buttons. All 17 call sites now pass `onRetry={() => void q.refetch()}`.
|
||||
- Expired/revoked token on session restore ([stores/auth.ts](../../../web/src/stores/auth.ts) `hydrate()` catch) now fires a Sonner toast with the shared `errors.419.*` copy and an "Open Settings" action (10 s duration — the 4 s default is too short for action toasts). Deliberately a toast, not a redirect: don't hijack whatever page the user opened. Auth gating on `/add` stays as-is.
|
||||
|
||||
## 🖼️ Images
|
||||
|
||||
- `decoding="async"` added to every `<img>` (10 sites: table thumbs, mobile cards, command palette, detail drawer, avatars, About QRs) — keeps image decode off the main thread during virtualised scrolling.
|
||||
- Detail drawer header image now goes through a new `preferWebp()` ([web/src/lib/image.ts](../../../web/src/lib/image.ts)): weserv WebP transcode (~50 KB → ~20 KB) on web, **direct Steam URL on Tauri desktop** (no third-party calls from the bundled app), with an `onError` fallback to the original. Replaces the old `<picture><source>` markup, which only falls back on unsupported *type* — a weserv outage would have shown a broken image. Thumbnails intentionally stay on direct Steam capsules (~10 KB, SW-cached); `webpProxyUrl` is no longer exported.
|
||||
|
||||
## ⌨️ Search responsiveness
|
||||
|
||||
- [GamesTable.tsx](../../../web/src/components/games/GamesTable.tsx): the Fuse.js search input is wrapped in `useDeferredValue` — typing stays per-keystroke responsive while filtering ~1.2k records lags at React's low priority. No debounce timer (deferral only delays when the machine is actually busy). Same treatment + `useMemo` for the command palette's game scan.
|
||||
|
||||
## 🧰 Tooling & misc
|
||||
|
||||
- `rollup-plugin-visualizer` devDependency + `npm run analyze` (`vite build --mode analyze` → `dist/stats.html` treemap, gzip/brotli sizes).
|
||||
- [index.html](../../../web/index.html): `preconnect` hints for `raw.githubusercontent.com` (shard fetches, crossorigin) and `shared.akamai.steamstatic.com` (thumbnails).
|
||||
- `npm audit fix` — react-router open-redirect advisory GHSA-2j2x-hqr9-3h42 (`react-router-dom` 6.30.x patch line); `npm audit` and `pip-audit` both report 0 known vulnerabilities.
|
||||
@@ -0,0 +1,26 @@
|
||||
# v3.4.0 – 2026-06-13 (The "Legal Consent Gate" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Feature release on top of v3.3.0 adding an explicit, up-front acceptance of the project's legal documents on both surfaces: a first-run consent gate in the app (web + desktop) and a real license-agreement page in the Windows installer. No backend, no cookies — acceptance is a single `localStorage` flag, versioned so it can re-prompt when the terms change, and naturally fresh in incognito/private tabs. Web app + desktop bumped `1.3.0` → `1.4.0`. Repo public-facing version `3.3.0` → `3.4.0`. Tag `v3.4.0` is GPG-signed; companion desktop tag is `desktop-v1.4.0`.
|
||||
|
||||
## ⚖️ First-run consent gate (web + desktop)
|
||||
|
||||
- New [ConsentGate.tsx](../../../web/src/components/common/ConsentGate.tsx) — a full-screen card (styled like the error pages, eager bundle, no flash) that blocks the main UI until the user ticks a checkbox and clicks **Continue**. Mounted inside `AppErrorBoundary` + `HashRouter` in [main.tsx](../../../web/src/main.tsx), wrapping `<App/>` (the `<Toaster/>` stays a sibling). A gate crash is still caught by the top-level boundary.
|
||||
- **Decline path** — explicit **Decline** button: on desktop (Tauri) it quits the app via `getCurrentWindow().close()`; on web it shows a blocking "you need to accept" notice with a way back to the gate.
|
||||
- **Persistence** — new [stores/consent.ts](../../../web/src/stores/consent.ts) (Zustand, same pattern as `stores/gpg.ts`): `localStorage` key `f2p:legal_consent` holding `{ version, acceptedAt }`. A `TERMS_VERSION` constant gates validity — bump it when the legal docs change materially and everyone is re-prompted. Incognito tabs get a fresh storage partition, so the gate re-shows there with zero extra code. No cookie is used anywhere (there is no server to read one).
|
||||
- **Error routes pass through** — the gate lets `#/error/*` render even before consent, so a mid-session chunk-load 503, the Pages `404.html` redirect, or an `#/error/:code` deep link still reaches the user instead of being swallowed.
|
||||
- **Doc links** — the gate's five binding documents (MIT License, EULA, Privacy Policy, Disclaimer, Terms of Use) open through the existing [external-open.ts](../../../web/src/lib/external-open.ts) `openExternal()` helper, so they work inside the Tauri webview (which blocks `window.open` to external HTTPS) as well as on the web.
|
||||
- **Shared legal list** — the `LEGAL_DOCS` array (label / path / hint) was lifted out of [About.tsx](../../../web/src/pages/About.tsx) into a reusable [lib/legal.ts](../../../web/src/lib/legal.ts) (`LEGAL_DOCS`, `CONSENT_DOCS`, `legalDocUrl()`); About now imports it instead of holding a private copy.
|
||||
- New `consent.*` i18n keys added to both [en.json](../../../web/src/i18n/locales/en.json) and [vi.json](../../../web/src/i18n/locales/vi.json). Long-form legal copy stays English (the doc labels come from `LEGAL_DOCS`); only the gate chrome is bilingual.
|
||||
|
||||
## 🪟 Windows installer license page
|
||||
|
||||
- [tauri.conf.json](../../../web/src-tauri/tauri.conf.json) now sets `bundle.licenseFile` to a new [LICENSE_AGREEMENT.rtf](../../../web/src-tauri/LICENSE_AGREEMENT.rtf). Tauri v2 surfaces this as a mandatory "I Agree" license page in **both** Windows targets built by `targets: "all"` — the NSIS `-setup.exe` (MUI license page) and the WiX `.msi` (which requires RTF). The RTF is plain ASCII with no BOM to avoid the known NSIS license-encoding bug.
|
||||
- The installer gate (install-time, desktop-only) and the in-app gate (first-run, web + desktop, re-promptable) are intentionally both kept: the auto-updater replaces the binary without re-running the installer, so the in-app `TERMS_VERSION` mechanism is the only way to re-prompt updated installs.
|
||||
- Desktop window-close on decline needs the `core:window:allow-close` permission, now added to [capabilities/default.json](../../../web/src-tauri/capabilities/default.json). New dependency `@tauri-apps/api` (official, lazy-imported only on the desktop decline path — no web-bundle bloat).
|
||||
|
||||
## 🧰 Tooling & misc
|
||||
|
||||
- Version bumped across the three desktop files ([web/package.json](../../../web/package.json), [tauri.conf.json](../../../web/src-tauri/tauri.conf.json), [Cargo.toml](../../../web/src-tauri/Cargo.toml)) → `1.4.0`; the stale README version badge corrected `3.2.7` → `3.4.0`.
|
||||
- Pre-publish suite (`typecheck`, `knip`, `npm audit`, `vulture`, `pip-audit`) re-run clean.
|
||||
@@ -0,0 +1,14 @@
|
||||
# v3.4.1 – 2026-06-14 (The "Chart Hotfix" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Patch release fixing a production regression introduced by the Vite 8 / Rolldown deploy hotfix (#95): every chart tab threw a blank **React error #130** and failed to render. Web app + desktop bumped `1.4.0` → `1.4.1`; repo public-facing version `3.4.0` → `3.4.1`.
|
||||
|
||||
## 🐛 Charts render again (React #130)
|
||||
|
||||
- [EChart.tsx](../../../web/src/components/charts/EChart.tsx) imported the chart wrapper from `echarts-for-react/lib/core` — the **CommonJS** build. Under Vite 8's Rolldown bundler the CJS default-interop wraps `module.exports = class` into a namespace object, so `<ReactEChartsCore/>` received an object instead of a component → React error #130 on **every** chart page (all [pages/charts/*](../../../web/src/pages/charts) + the [Dashboard](../../../web/src/pages/Dashboard.tsx)). Switched the import to the **ESM** build `echarts-for-react/esm/core`, which has a clean `export default`. echarts core and echarts-wordcloud were already ESM, so this single import was the only offender.
|
||||
- Verified at **runtime against the production (Rolldown) build** (the step skipped in #95): bar, pie/donut, line, treemap, heatmap and wordcloud charts all render with zero console errors. `echarts`/`openpgp` remain lazy async chunks (not eager-preloaded in `index.html`).
|
||||
|
||||
## ⚠️ glib advisory (Linux desktop) — acknowledged, no upstream fix
|
||||
|
||||
- The Dependabot alert for the `glib` crate ([GHSA-wrw7-89jp-8q8g](https://github.com/advisories/GHSA-wrw7-89jp-8q8g), medium, Linux-only) cannot be resolved within Tauri 2.x: the latest `webkit2gtk` crate (2.0.2) pins `glib ^0.18`, `tao`/`wry` pin `gtk ^0.18`, and Tauri 3 is not released. Only the Linux build links glib (Windows = WebView2, macOS = Cocoa) and the app does not call the affected API, so the alert is dismissed as tolerable risk. Will revisit when the upstream stack adopts gtk-rs 0.20. See [TAURI.md](../../../web/src-tauri/TAURI.md).
|
||||
@@ -0,0 +1,23 @@
|
||||
# v3.4.2 – 2026-06-15 (The "Android Floor" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Android-focused release that raises the APK's minimum OS, hides a desktop-only
|
||||
affordance on phones, and documents the support policy with sourced numbers. Web
|
||||
app + desktop/Android bumped `1.4.3` → `1.4.4`; repo public-facing version
|
||||
`3.4.1` → `3.4.2`. Tag `v3.4.2` is GPG-signed; the Android APK ships from
|
||||
`android-v1.4.4`.
|
||||
|
||||
## 🤖 Minimum Android raised to 11 (API 30)
|
||||
|
||||
- [build.gradle.kts](../../../web/src-tauri/gen/android/app/build.gradle.kts) `minSdk` `24` → `30`. Android's package installer refuses to install the APK below this (`INSTALL_FAILED_OLDER_SDK`), so the version floor doubles as the OS-level install gate — no in-app check, no bypass. Don't re-run `tauri android init` (it would reset it).
|
||||
- **Why 11, not lower:** Android 7–10 are deeply end-of-life — Google ships OS security backports only for 14/15/16 as of mid-2026 — and tend to carry an outdated System WebView that breaks the modern ES2022 / React 19 output of the Vite 8 / Rolldown bundle. A `minSdk 30` floor still reaches ~87% of active Android devices (StatCounter, May 2026) while dropping only the dead tail. Android 11–13 install but no longer get Google OS patches — called out explicitly in the docs.
|
||||
|
||||
## 📱 "Steam Desktop" button hidden on mobile
|
||||
|
||||
- The `steam://` "Steam Desktop" button in [GameDetailDrawer.tsx](../../../web/src/components/games/GameDetailDrawer.tsx) can't reach a Steam client on a phone, so it's now hidden on the Android app **or** a sub-768px viewport; the "Web" button stays. Gated by a new reactive [useIsMobile.ts](../../../web/src/hooks/useIsMobile.ts) hook (`useSyncExternalStore` + `matchMedia("(max-width: 767px)")`, OR the existing `isAndroid()` from [external-open.ts](../../../web/src/lib/external-open.ts)) — re-renders on resize / rotation. No new i18n strings.
|
||||
|
||||
## 📚 Docs & transparency
|
||||
|
||||
- New [docs/android-support.md](../../../docs/android-support.md) (+ Vietnamese mirror [i18n/vi/android-support.md](../../../docs/i18n/vi/android-support.md)): minimum requirement, full rationale (security/EOL, WebView/React compatibility, edge-to-edge), tested-device matrix (emulator Android 11→16, real **vivo 1907** on Android 12), and a worldwide version-share + security-EOL table with **cited sources** ([apilevels.com](https://apilevels.com/), [StatCounter](https://gs.statcounter.com/android-version-market-share/mobile/worldwide/), [endoflife.date](https://endoflife.date/android), [Android Security Bulletins](https://source.android.com/docs/security/bulletin)). Reused as the GitHub Discussion announcement.
|
||||
- Updated [TAURI.md](../../../web/src-tauri/TAURI.md), [pc_spec.md](../../../docs/pc_spec.md) (+ VN mirror) with the new Android test-device section, the [release-android.yml](../../../.github/workflows/release-android.yml) release-notes template, and the [README](../../../README.md) (version badge `3.4.1`→`3.4.2`, new Android 11+ badge + Quick-links row).
|
||||
@@ -0,0 +1,51 @@
|
||||
# v3.4.3 – 2026-09-11 (The "Own Domain" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The site moved off GitHub Pages to **free-steam-games.win** on Cloudflare, and
|
||||
the catalogue gained a reviewed intake path for new games plus durable manual
|
||||
corrections. Web app + desktop/Android bumped `1.4.4` → `1.4.5`; repo
|
||||
public-facing version `3.4.2` → `3.4.3`. Tags `v3.4.3`, `desktop-v1.4.5` and
|
||||
`android-v1.4.5` are GPG-signed; both binary workflows publish **draft**
|
||||
releases.
|
||||
|
||||
## 🌐 New home
|
||||
|
||||
- Served by a Cloudflare Worker with static assets; data is proxied same-origin
|
||||
at `/api/data/*`, Steam art at `/img/*`. Details: [docs/DEPLOYMENT.md](../../../docs/DEPLOYMENT.md).
|
||||
- Real URLs on the web (`/games/730`) instead of `/#/games/730`; old hash links
|
||||
are upgraded on load. The desktop/Android shell keeps hash routing.
|
||||
- Content-Security-Policy and hardening headers, with a check command for every
|
||||
setting in [docs/SECURITY_SETUP.md](../../../docs/SECURITY_SETUP.md).
|
||||
|
||||
## 📥 New games: discovered, then reviewed
|
||||
|
||||
- `Discover New Games` sweeps the Steam store daily into a review queue; the
|
||||
maintainer approves at `/admin` (behind Cloudflare Access). Approval queues
|
||||
the game for `ingest_new.py`, and a reconcile cron confirms it landed.
|
||||
- Submissions from outside now come only through the
|
||||
[browser extension](https://github.com/poli0981/steam-f2p-extension); the
|
||||
issue-template and Telegram-bot paths were removed.
|
||||
|
||||
## ✏️ Corrections that survive the pipeline
|
||||
|
||||
- Manual fixes (genre, notes, anti-cheat…) live in
|
||||
`data/overrides/<appid>.json` and are re-applied on every write, so a refetch
|
||||
or genre normalisation can no longer revert them. Edit from `/admin/edit`
|
||||
(single game or bulk by genre) or `scripts/edit_game.py`.
|
||||
|
||||
## 📄 Data & licensing
|
||||
|
||||
- Dataset licensed separately under CC BY 4.0 ([LICENSE-DATA](../../../LICENSE-DATA));
|
||||
code stays MIT. Terms updated, so the consent prompt appears once more.
|
||||
- `description` is now a short quotation — capped at 180 characters and
|
||||
attributed in the app.
|
||||
- The bulk markdown tables in `games/` were removed; the two leaderboards stay.
|
||||
|
||||
## 🖥️ Desktop & Android
|
||||
|
||||
- Packaged apps now read from free-steam-games.win; the Worker sends CORS for
|
||||
`/api/data/*` so they can. Builds made from `main` before this fix could not
|
||||
load the catalogue — no released build was affected.
|
||||
- The Tauri webview has a real CSP (`ipc:` included, so native calls keep
|
||||
working). **Smoke-test the draft builds before publishing.**
|
||||
@@ -0,0 +1,208 @@
|
||||
# v4.0.0 – 2026-09-17 (The "Rewrite" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The end-user web app was rewritten from React 19 to **SvelteKit 2 / Svelte 5**,
|
||||
given a typeface and a palette of its own, and gained the pages it had been
|
||||
missing. `/admin` was rebuilt as an app of its own, embedded in the Worker. The
|
||||
data path now verifies every shard it caches, every game has a page search
|
||||
engines can read, the web app is installable, and the desktop app updates
|
||||
itself. Web app + desktop/Android bumped `1.4.5` → `2.0.0`; repo public-facing
|
||||
version `3.4.3` → `4.0.0`.
|
||||
|
||||
Breaking for anyone who packaged or embedded the old build: the desktop window
|
||||
is now resizable, the `tauri-plugin-http` native bridge is gone, and the
|
||||
Content-Security-Policy is emitted by the app itself rather than by
|
||||
`_headers`.
|
||||
|
||||
Deploying it needs one manual step: `npx wrangler d1 migrations apply f2p-admin
|
||||
--remote` (migration `0002_admin_state.sql`). The Worker runs without it,
|
||||
degraded, and `/admin/health` says so.
|
||||
|
||||
## 🎨 A front end that looks like something
|
||||
|
||||
- **Rewritten on SvelteKit 2 + Svelte 5 runes.** 30 routes, prerendered to
|
||||
static HTML — every page now ships real markup to a crawler instead of an
|
||||
empty shell. React, react-router, zustand, TanStack Query, cmdk and Radix
|
||||
are gone; Bits UI, `@tanstack/svelte-virtual` and svelte-sonner replace
|
||||
them.
|
||||
- **Three self-hosted typefaces**, subsetted to Latin, Latin-Ext and
|
||||
Vietnamese: Bricolage Grotesque for display, IBM Plex Sans for body and the
|
||||
3,666-row table, JetBrains Mono for figures. The old build declared `Inter`
|
||||
and shipped no font file at all, so it had always rendered in `system-ui`.
|
||||
- **A warm amber palette**, replacing the Tailwind 3 defaults the previous
|
||||
version kept "until the palette rework", plus a skip link, a
|
||||
`:focus-visible` rule and a `prefers-reduced-motion` block — none of which
|
||||
had ever existed.
|
||||
- **A brand mark that is geometry, not a font glyph.** The old icon drew "▶"
|
||||
as SVG `<text>` in `system-ui`: a different shape on every platform, and
|
||||
tofu where no font supplied it.
|
||||
|
||||
## 📄 New pages
|
||||
|
||||
- `/legal/:doc` — all eight documents, rendered from the repo's markdown **at
|
||||
build time**, so no markdown parser or sanitiser reaches the browser. The
|
||||
welcome screen used to intercept these links and redirect to `/about`.
|
||||
- `/games/:appid` — a real page per game, **prerendered for all ~3,600 games**
|
||||
from build-time seeds with `VideoGame` structured data, and listed in the
|
||||
sitemap. Player counts and reviews still come live from the catalogue.
|
||||
- `/welcome` — a first-run introduction, shown once after the terms are
|
||||
accepted: what the list is and is not, three ways in, the language, and the
|
||||
documents just accepted.
|
||||
- `/legal` — an index of the documents. An unknown document is a translated
|
||||
404 rather than the dashboard.
|
||||
- `/developers`, `/developers/:name`, `/publishers/:name` — `developer[]` and
|
||||
`publisher[]` were on every record and used by nothing.
|
||||
- `/stats` — the fields no chart covered: Metacritic distribution, peak-vs-now
|
||||
retention, safety flags, language coverage, review-label buckets, and when
|
||||
games went quiet.
|
||||
- `/charts/time` gains catalogue growth (added per month, running total), and
|
||||
the anti-cheat index is a searchable, sortable table.
|
||||
|
||||
## 🔎 Findable
|
||||
|
||||
- **Open Graph and Twitter cards on every page.** There were none, so a shared
|
||||
link rendered as a bare grey URL everywhere. `og:image` is a real 1200×630
|
||||
PNG — it used to point at an SVG, which no social platform renders.
|
||||
- **Canonical URLs on every page**, not just `/games/:appid`.
|
||||
- **`sitemap.xml` generated from the route table.** The old one listed four
|
||||
URLs, three of them pointing at github.com, and none of the app's own routes.
|
||||
- PNG icons for the PWA manifest and `apple-touch-icon`, which never accepted
|
||||
SVG.
|
||||
|
||||
## 🛠️ `/admin` rebuilt
|
||||
|
||||
- **Its own app.** The two Worker-rendered pages (1,400 lines of HTML and
|
||||
script inside template literals) are replaced by a Svelte 5 app in
|
||||
`web/admin/`, embedded in the Worker and served only behind Cloudflare
|
||||
Access, with a nonce-only script policy. None of it reaches `dist/`, the
|
||||
service worker or the packaged apps, and the build fails if any does.
|
||||
- **Decided rows are read-only.** Approved, committed and rejected rows, and
|
||||
undecided rows for a game that is already published, have no checkbox and
|
||||
are skipped by select-all. The server enforces the same rules from one shared
|
||||
module, and every row a decision cannot touch comes back with a reason
|
||||
instead of being dropped silently.
|
||||
- **Reopen** a rejected row from its details, with the reason when it cannot be.
|
||||
- Every decision is confirmed first; tabs, search, sort and page live in the
|
||||
URL; keyboard shortcuts; a phone layout.
|
||||
- **Corrections** are reviewed as a diff before the commit, bulk changes can set
|
||||
or retire any field across pages, and a settled override file can be deleted.
|
||||
- **Jobs, Audit and Health** have their own pages. Health still draws its table
|
||||
when the answer is a 503, and Test write proves the write path.
|
||||
- Deferring or requeueing a failed row next to an open one no longer 500s; an
|
||||
approval whose commit landed but whose queue update failed says exactly that
|
||||
and leaves its job marked committed.
|
||||
- **Reconcile** holds a D1 lease, sweeps undecided rows whose game appeared in
|
||||
`data/` by another route, and skips the dataset fetch while nothing changed.
|
||||
- `audit_log` and `commit_jobs` are pruned after 180 days, as the privacy
|
||||
policy now says.
|
||||
- `npm run dev:admin` runs the real handlers against an in-memory database, so
|
||||
the admin can be worked on without deploying it.
|
||||
|
||||
## 🧮 Data you can trust
|
||||
|
||||
- `data/index.json` carries a **SHA-256 per shard**, and `last_updated` changes
|
||||
only when the data did — a pipeline run that changed nothing no longer makes
|
||||
every visitor re-download ~6 MB.
|
||||
- The Worker serves `?v=<sha256>` shard requests content-addressed and
|
||||
immutable, and refuses (503) while GitHub's CDN still has the previous bytes.
|
||||
- The app caches only a generation whose hashes verified, keeps the last good
|
||||
one for offline use, and re-checks when the tab comes back. A long-lived tab
|
||||
used to show a count and date days out of date.
|
||||
|
||||
## 📲 Installable, and updatable
|
||||
|
||||
- The web app registers its service worker (it never had, on the SvelteKit
|
||||
build), offers installation, works offline, and asks before reloading into an
|
||||
update.
|
||||
- The **desktop app updates itself**: it checks a feed at
|
||||
`/api/updates/desktop`, which offers only a published `desktop-v*` release,
|
||||
shows the notes, and restarts into the new version. The old endpoint pointed
|
||||
at the repository's "latest" release, usually a dataset release, and 404'd.
|
||||
- Updating no longer wipes settings: the webview is cleared once, only when
|
||||
coming from a build older than 2.0.
|
||||
- `steam://` links open the Steam client from the apps.
|
||||
|
||||
## 🔐 Security
|
||||
|
||||
- **A negative `limit` disabled the SQL bound.** `Math.min(Number("-1") || 50,
|
||||
200)` is `-1`, and SQLite treats a negative LIMIT as unlimited — so
|
||||
`?limit=-1` dumped the entire never-pruned audit log. Clamped.
|
||||
- **A token with a missing or non-numeric `exp` never expired.** `exp` is now
|
||||
required and numeric.
|
||||
- **The JWT is no longer accepted from a cookie on writes.** Only the
|
||||
`Cf-Access-Jwt-Assertion` header, which browsers never send cross-site.
|
||||
- A signing-key rotation locked out admin and ingest for up to an hour as an
|
||||
opaque 404; the JWKS is refetched once on an unknown `kid`, and a fetch
|
||||
failure is now a 503 rather than "not found".
|
||||
- Every server crash was reported to the reviewer as "Session expired" — the
|
||||
admin pages sniff Content-Type, and an unhandled throw became Cloudflare's
|
||||
HTML 1101 page. There is a top-level handler now.
|
||||
- A reject can no longer downgrade an approved game, which would have made it
|
||||
permanently invisible to every future discovery sweep.
|
||||
- `header_image` is validated as an HTTPS Steam CDN URL, not merely
|
||||
length-capped.
|
||||
|
||||
## ✅ Tests, where there were none
|
||||
|
||||
`docs/ADMIN.md` claimed the override byte-parity between `scripts/edit_game.py`
|
||||
and the Worker was "asserted by a parity test". No test existed anywhere in the
|
||||
repo. Vitest now covers the app, the Worker (against a real SQLite database with
|
||||
the real migrations) and the admin app; pytest covers the index hashing; cargo
|
||||
covers the upgrade purge. The first 95 were each checked by mutation, not
|
||||
merely by passing. `verify-dist.mjs` reads the built HTML in CI for the
|
||||
mistakes that only exist there.
|
||||
|
||||
## 🖥️ Binary 2.0.0
|
||||
|
||||
- **The window unlocks.** It was pinned to exactly 1400×900, non-resizable and
|
||||
non-maximisable, which made a responsive redesign pointless on the one
|
||||
platform that could not use it. Now 1280×860, resizable, minimum 880×600.
|
||||
- **`tauri-plugin-http` removed** along with its `https://github.com/*`
|
||||
capability. It existed for the GitHub OAuth Device Flow, which went with
|
||||
sign-in; the only remaining GitHub call is the Android release check, which
|
||||
is a plain `fetch` to an endpoint that sends CORS headers.
|
||||
- Real paths, no hash router. `tauri::manager::get_asset()` resolves
|
||||
`/games/730` through its own fallback chain; the note claiming the webview
|
||||
had no server-side fallback was out of date. Links from released 1.4.x
|
||||
builds are still upgraded on load.
|
||||
|
||||
## 🐛 Fixed on the live site
|
||||
|
||||
- Raw placeholders on screen: `Languages ({{count}})`, `(PEAK {{PEAK}})` as a
|
||||
field label, `(peak {{peak}})` on a chart axis, and one in a prerendered meta
|
||||
description. A test now reads every call site.
|
||||
- Hovering a chart tile, bar or slice blanked it (the colour format zrender
|
||||
cannot parse), the genre treemap tooltip printed `({d}%)`, and axis names
|
||||
were clipped on `/stats`.
|
||||
- The command palette crashed on open (a duplicate route), the consent overlay
|
||||
covered the documents it asked people to read, unknown URLs rendered the
|
||||
dashboard, and old `/#/` links changed the address bar without the page.
|
||||
- Vietnamese readers saw English for the legal document names, the table's
|
||||
data-issue hints and the About page's stack. 137 locale keys nothing used any
|
||||
more are gone, and a test fails on the next one.
|
||||
- The report-only CSP messages in the console come from Cloudflare's
|
||||
Continuous script monitoring, not the site; `docs/SECURITY_SETUP.md` says how
|
||||
to turn it off.
|
||||
|
||||
## 🐛 Console
|
||||
|
||||
Every reported error is fixed, and each was measured rather than assumed:
|
||||
|
||||
- GitHub avatars were blocked by CSP on `/activity`. They are proxied through
|
||||
the Worker at `/img/gh/*`, so `img-src` stays `'self'`.
|
||||
- The Cloudflare Access re-auth fetch was blocked. It uses a full-page
|
||||
redirect now.
|
||||
- `[Violation] 'setTimeout' handler took 122ms` — zero long tasks while four
|
||||
charts initialise, because each waits for an IntersectionObserver instead of
|
||||
all of them racing in one frame.
|
||||
- `[Violation] non-passive 'mousewheel' listener` — zrender binds both `wheel`
|
||||
and `mousewheel` with no options object, unconditionally. Four blocking
|
||||
listeners for two charts, measured; now zero.
|
||||
|
||||
## 📇 Contact
|
||||
|
||||
The maintainer address is **contact@poli0981.dev**; every other channel is
|
||||
`https://poli0981.dev/links/`. `CODE_OF_CONDUCT.md` had no reporting address at
|
||||
all. `/.well-known/security.txt` exists and is served as `text/plain` — it used
|
||||
to return the app shell with HTTP 200.
|
||||
@@ -0,0 +1,133 @@
|
||||
# v4.0.1 – 2026-09-23 (The "Human Check" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The web app now asks each browser to pass a Cloudflare Turnstile check once a
|
||||
day after the terms are accepted, shows a changed legal document as a diff
|
||||
instead of asking for a full re-read, and counts page views with Cloudflare
|
||||
Web Analytics. The desktop app's game artwork - blank because its webview
|
||||
sends a Referer the zone's Hotlink Protection refuses - is back, and nothing in
|
||||
the app loads data before the reader is past the consent step and the check. Web app + desktop/Android
|
||||
bumped `2.0.0` → `2.0.1`; repo public-facing version `4.0.0` → `4.0.1`.
|
||||
|
||||
The web changes are already live - pushing `main` deploys. The desktop app
|
||||
offers 2.0.1 through its updater once the release is published; on Android,
|
||||
install the new APK over the old one. Returning visitors see the consent gate
|
||||
once, listing only the Privacy Policy and Terms of Use changes.
|
||||
|
||||
## ✨ Added
|
||||
|
||||
- **A legal document that changes now shows you the change, not the whole
|
||||
document again.** Each binding document is hashed at build time
|
||||
(`virtual:legal-versions`); when one differs from the version you accepted,
|
||||
the consent gate reopens on its own and lists only that document, with a
|
||||
`+`/`-` diff against the copy kept in your browser. `TERMS_VERSION` is no
|
||||
longer the only signal — it stays as the lever that forces a full re-read.
|
||||
Clearing site data removes the stored copy, and the gate then links to the
|
||||
full text instead.
|
||||
- **Cloudflare Web Analytics**, cookieless, loaded only after you accept the
|
||||
terms and never in the desktop or Android apps. It replaces an "automatic"
|
||||
edge injection that had been enabled for months and could never have worked:
|
||||
it inserts an inline script, and a hash-based CSP ignores `'unsafe-inline'`
|
||||
by specification, so it only ever produced two console errors per page load.
|
||||
Measured on the live site: the beacon returns 200 and its reports 204, with
|
||||
nothing loaded at all before consent.
|
||||
- **A human-verification step for suspicious page loads, and a country block**
|
||||
(mainland China, Russia, Argentina). Both are WAF custom rules, live since
|
||||
2026-09-20 and documented with their expressions and every exclusion in
|
||||
`docs/SECURITY_SETUP.md`. Verified after they went live: a plain `curl` with
|
||||
no browser User-Agent is still served every public path, and the challenge
|
||||
rate has stayed at 0%. `BLOCKED_COUNTRIES` in `wrangler.jsonc` makes the
|
||||
Worker refuse the same countries as defence in depth; the rule is the
|
||||
boundary, because prerendered pages never reach the Worker at all.
|
||||
- **A Cloudflare Turnstile check on the website**, separate from the WAF
|
||||
challenge above: after accepting the terms, each browser passes a Turnstile
|
||||
widget at most once every 24 hours before the app loads its data. The Worker
|
||||
verifies the token at `POST /api/human-check` with the `TURNSTILE_SECRET`
|
||||
secret, checking the action and the hostname; nothing is stored server-side.
|
||||
It is an overlay like the consent gate, so prerendered pages and crawlers are
|
||||
unaffected, and it is soft on purpose: `/api/data/*`, `/img/*` and the
|
||||
desktop and Android apps never require it (the Terms of Use promise as much).
|
||||
It refuses only when Cloudflare says no; a missing secret, a siteverify
|
||||
outage, a widget misconfiguration or being offline let the reader through for
|
||||
that page load. The web CSP gains `challenges.cloudflare.com` in `script-src`
|
||||
and a new `frame-src`; `verify-dist.mjs` fails the Tauri build if either
|
||||
appears there. The privacy policy and the terms describe it, so returning
|
||||
visitors see those two documents' changes at the consent gate once.
|
||||
|
||||
## 🐛 Fixed
|
||||
|
||||
- **Game artwork was blank in the desktop app** (and would be on Android): the
|
||||
WebView2 webview sends `Referer: http://tauri.localhost/`, and the zone's
|
||||
Hotlink Protection refused every `/img/*` request carrying it — before the
|
||||
Worker ran, so nothing in the app's logs showed it. Every `<img>` now sets
|
||||
`referrerpolicy="no-referrer"`, which the protection allows, and
|
||||
`src/lib/images.test.ts` fails on one that does not. That also fixes the
|
||||
thumbnails `npm run dev` could never show. Installed 2.0.0 apps are covered
|
||||
by a Configuration Rule on the zone until they update; Hotlink Protection
|
||||
itself stays on for other sites.
|
||||
- **`/activity` and `/charts/delisted` fetched their data before consent.** The
|
||||
root layout held the catalogue back, but those two pages called `load()`
|
||||
from effects of their own, and the activity feed also refetched on window
|
||||
focus. The gate now lives in `Resource` itself: an `enabled` option read
|
||||
inside every `load()`, which every resource sets to `appReady()` - consent
|
||||
accepted and the human check cleared - so a held-back load starts by itself
|
||||
once both are passed. `src/lib/resource.test.ts` fails on a `new Resource`
|
||||
without it.
|
||||
- **The service worker threw `non-precached-url: /200.html` on every page
|
||||
load.** `navigateFallback` named the adapter-static fallback, which is
|
||||
written into `dist/` after workbox has already globbed the build output — so
|
||||
it was never in the precache, and the throw abandoned the rest of the
|
||||
worker's setup. It is now `/`, which is both precached and what Cloudflare
|
||||
and Tauri already serve for an unmatched path. `verify-dist.mjs` fails the
|
||||
build if the two ever disagree again.
|
||||
- **`/admin` no longer writes the maintainer's email address into public Git.**
|
||||
Commit bodies and `data/overrides/*.json` say `admin`; the four override
|
||||
files that already carried it were rewritten. The acting identity is still
|
||||
recorded in D1, where `/admin/audit` reads it.
|
||||
|
||||
- **`/admin` said "Your Cloudflare Access session has expired" straight after
|
||||
signing in, in a private window too.** Its API was at `/api/admin/*`, behind
|
||||
a second Cloudflare Access application. Access issues its session cookie per
|
||||
application and `fetch()` cannot follow the sign-in redirect, so the session
|
||||
for `/admin` never reached the API and every call bounced to the login page.
|
||||
The API now lives at `/admin/api/*`, under the page's own application, and
|
||||
`worker/index.test.ts` drives it through the real router and token check.
|
||||
The `/api/admin` Access application is no longer used and can be deleted.
|
||||
- `scripts/discover_new.py` took any host ending in `cloudflareaccess.com` for
|
||||
an Access login page, lookalikes included; the suffix check now needs the dot.
|
||||
- The i18n, SEO and chart tests share one comment stripper instead of three
|
||||
regexes, one of which removed text that was never inside a comment.
|
||||
|
||||
## 📚 Docs
|
||||
|
||||
- `docs/ACKNOWLEDGEMENTs.md` listed the dependencies of the **React** app —
|
||||
React 18, react-router, i18next, Zustand, TanStack Query, Radix, shadcn/ui,
|
||||
OpenPGP.js, Tailwind 3, TypeScript 5, PostCSS. None of that has shipped since
|
||||
the v4 rewrite. Replaced with the real list, licences checked against
|
||||
`node_modules` rather than remembered (`echarts-wordcloud` is ISC, not
|
||||
BSD-3-Clause), and the claim that `/about` carries a "full SPDX list" dropped
|
||||
— it is a curated subset.
|
||||
- `docs/DEPLOYMENT.md` records that a zero-duration "Workers Builds" failure on
|
||||
a PR branch is a preview-build artefact, not a broken commit, so the next
|
||||
person does not go looking for a bug that is not there.
|
||||
- `docs/SECURITY_SETUP.md` section 10 claimed the packaged apps survived Hotlink
|
||||
Protection because their webview sent no Referer, recommended switching the
|
||||
protection off, and said no allowlist could express the apps' origin. The
|
||||
first was no longer true and the last never was; it now documents the
|
||||
per-image fix and the Configuration Rule, with the measured check. A new
|
||||
section 12 covers the Turnstile widget settings, the secret and local testing
|
||||
with Cloudflare's test keys (`web/.dev.vars.example`).
|
||||
- Stale `public/_headers` paths (the file has been `static/_headers` since the
|
||||
SvelteKit move) and a `SITE_ORIGIN` that is really `API_ORIGIN` in
|
||||
`src/lib/site.ts` are corrected in `worker/lib/http.ts`, `svelte.config.js`
|
||||
and the security doc; `_headers` itself gains comments on why images opt out
|
||||
of its Referrer-Policy.
|
||||
|
||||
## 🛠 CI
|
||||
|
||||
- The Android release builds the tag it releases (a manual run used to build
|
||||
`main`), installs `platform-tools` only (the SDK no longer carries `tools`,
|
||||
which stopped `android-v2.0.0`), and names the commit it built.
|
||||
- CodeQL also runs when only `.mjs`/`.cjs` files change, and
|
||||
`verify-dist.mjs` finds `<script>`/`<style>` by scanning.
|
||||
@@ -0,0 +1,56 @@
|
||||
# v4.0.2 – 2026-09-29 (The "Right Address" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
A game's tags, languages and store details are now re-read on a rotation
|
||||
instead of being fetched once and never again, a long data job no longer loses
|
||||
its work when something else lands on `main`, and each kind of message now has
|
||||
an address of its own. Web app + desktop/Android bumped `2.0.1` → `2.0.2`; repo
|
||||
public-facing version `4.0.1` → `4.0.2`.
|
||||
|
||||
The web changes are live as soon as this merges. The desktop app offers 2.0.2
|
||||
through its updater once the release is published; on Android, install the new
|
||||
APK over the old one. Returning visitors see the consent gate once, listing
|
||||
the Privacy Policy, the Terms of Use and the Data Licence — each changed only
|
||||
by a contact address, and the gate shows exactly that line.
|
||||
|
||||
## ✨ Added
|
||||
|
||||
- **Tags, languages and the rest of a game's store data now stay current.**
|
||||
`update_data.py` only fills in incomplete records, and only empty fields, so
|
||||
once a game had its tags, languages, platforms or header image nothing looked
|
||||
at them again short of a manual full re-fetch. `Refresh Store Data` (daily,
|
||||
16:00 UTC) re-reads them on a rotation: the store page - tags, languages and
|
||||
their details, the paid-DLC flag - for every game once a week, and
|
||||
appdetails - name, header image, description, developer and publisher,
|
||||
release date, platforms, Metacritic, DRM notes - once a month. About 630
|
||||
store pages and 150 appdetails calls a day instead of 8,800 requests in one
|
||||
sitting. It never blanks a value on a failed or age-gated page, never
|
||||
touches the hand-set fields (genre, type, anti-cheat, safety, notes), and
|
||||
marks a game updated only when something changed. A dry run on three games
|
||||
found all three with tags that had drifted since they were first fetched.
|
||||
|
||||
## 🐛 Fixed
|
||||
|
||||
- **A long data job lost its work if anything landed on `main` meanwhile.**
|
||||
`purge-unhealthy` ran for four hours on 2026-09-21 and then failed on
|
||||
`push rejected (fetch first)`: the data-write group serialises workflows,
|
||||
but a merged pull request or an `/admin` commit still moves `main`. Every
|
||||
data job now commits through `bash/commit_push.sh`, which rebases onto
|
||||
`origin/main` and retries the push.
|
||||
|
||||
## 📇 Contact
|
||||
|
||||
`contact@poli0981.dev` stays the default. Three role addresses join it, each
|
||||
published where a reader of that document would look:
|
||||
|
||||
| Address | For | Where |
|
||||
|---|---|---|
|
||||
| `security@poli0981.dev` | vulnerabilities, after GitHub's private reporting | `SECURITY.md`, `/.well-known/security.txt` |
|
||||
| `privacy@poli0981.dev` | privacy questions | Privacy Policy |
|
||||
| `copyright@poli0981.dev` | copyright, DMCA and takedown notices | Data Licence, Terms of Use §6 |
|
||||
|
||||
The maintainer's website, <https://poli0981.dev/>, is on the About page next
|
||||
to the email and the links page. `security.txt` now lists GitHub's private
|
||||
vulnerability reporting first and `security@` second, in RFC 9116 preference
|
||||
order. The full map is in `AUTHORS.md` and `docs/Contact.md`.
|
||||
@@ -0,0 +1,67 @@
|
||||
# v4.1.0 – 2026-10-02 (The "Featherweight" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Game art and the catalogue both got much lighter, the deploy log lost its
|
||||
noise, and scrollbars finally look like the rest of the site. Web app +
|
||||
desktop/Android bumped `2.0.2` → `2.1.0`; repo public-facing version `4.0.2` →
|
||||
`4.1.0`.
|
||||
|
||||
The web changes are already live. The desktop app offers 2.1.0 through its
|
||||
updater once the release is published, and brings the packed catalogue with
|
||||
it; on Android, install the new APK over the old one. Returning visitors see
|
||||
the consent gate once, showing one new line in the Privacy Policy: the storage
|
||||
key of the new scrollbar setting.
|
||||
|
||||
## ✨ Added
|
||||
|
||||
- **Game art is AVIF now - heroes about 58% smaller, thumbnails about 92%.**
|
||||
The Worker's 15-minute cron encodes each game's Steam header once with
|
||||
Cloudflare Images - a 230 px thumbnail and a 460 px hero - and stores it in
|
||||
R2; every request after that is served from the stored copy, never encoded
|
||||
on the fly. The ten most-played heroes went from 40 KB to 16.8 KB (SSIM
|
||||
0.979 against Steam's JPEG); thumbnails are ~3.4 KB. Most-played games go
|
||||
first, the whole catalogue takes about a day and a half, and a hard monthly
|
||||
cap keeps the Images bill bounded. Browsers that do not take AVIF keep
|
||||
getting Steam's JPEG, and social cards always do.
|
||||
- **The catalogue downloads in about a seventh of the bytes.** The app now
|
||||
reads each shard as a packed file (`/api/data/p1/*.bin`, 224 KB instead of
|
||||
1.5 MB): compressed, and wrapped so the site's API is no longer a
|
||||
ready-made JSON feed. It is obfuscation, not secrecy - the readable dataset
|
||||
is the repository, as it always was. The app checks what it unpacks against
|
||||
`index.json` exactly as before, and the released apps keep reading the
|
||||
plain files.
|
||||
- **Scrollbars match the site, and can be hidden.** A warm thumb that turns
|
||||
amber under the pointer, in both themes. Settings → Scrollbars: Visible,
|
||||
Hidden in tables and panels, or Hidden everywhere; hidden bars still scroll
|
||||
with the wheel, trackpad, touch or keyboard.
|
||||
|
||||
## 🐛 Fixed
|
||||
|
||||
- **Every deploy log was 91% noise.** The build printed one
|
||||
`[404] GET /img/…` per prerendered game - 5,566 lines - and rendered an
|
||||
error page for each. They were harmless (a Worker route the build cannot
|
||||
see), but they buried anything worth reading. Now there are none.
|
||||
- **The plain catalogue went out uncompressed.** Cloudflare does not compress
|
||||
`application/x-ndjson` by default, so every full load moved ~9 MiB. A
|
||||
Compression Rule now brotli-compresses those files for every client,
|
||||
released apps included (1.5 MB → 226 KB per shard).
|
||||
- **Tables showed the operating system's grey scrollbar.** Tailwind 4.3's own
|
||||
`scrollbar-thin` merged with ours and, in Chromium, switched the themed bar
|
||||
off. Ours is now `scrollbar-slim`, with a test that keeps it that way.
|
||||
- **Thumbnails cost two guaranteed 404s on half the catalogue**, probing for a
|
||||
Steam capsule that hashed paths never have, and stray query strings forked
|
||||
the image edge cache.
|
||||
- **A data-only commit redeployed the whole site** (5,681 files), against
|
||||
what `docs/DEPLOYMENT.md` intends. The fix is the Workers Builds watch
|
||||
paths, a dashboard setting.
|
||||
|
||||
## 🔐 Security
|
||||
|
||||
- **`/img/*` can no longer be used to run up the image bill.** With
|
||||
Cloudflare's URL transformations enabled, `/cdn-cgi/image/<options>/img/…`
|
||||
let anyone bill a new transformation per option set, through a proxy that
|
||||
serves any Steam game's art - a scanner found such a URL within minutes. The
|
||||
Worker now refuses the transformation service as a client, and URL
|
||||
transformations are switched off for the zone; the cron's encoding does not
|
||||
need them.
|
||||
@@ -0,0 +1,75 @@
|
||||
# v4.1.1 – 2026-10-03 (The "Pocket-Sized" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The site and the apps fit a phone: nothing runs off the right edge, game
|
||||
names are back in the leaderboards, and the Android app no longer puts its
|
||||
top bar under the clock. Web app + desktop/Android bumped `2.1.0` →
|
||||
`2.1.1`; repo public-facing version `4.1.0` → `4.1.1`.
|
||||
|
||||
On the website the phone fixes go live with this release; the caching
|
||||
changes below already were. The desktop app offers 2.1.1 through its updater
|
||||
once the release is published; on Android, install the new APK over the old
|
||||
one. The apps also pick up the Privacy Policy line about the image host
|
||||
below, so they show the consent gate once, with that paragraph; the website
|
||||
already did.
|
||||
|
||||
## 📱 Fits a phone
|
||||
|
||||
- **Nothing runs off the right edge any more.** On a phone, the Dashboard's
|
||||
"Top genres", "Playing right now" and chart cards, and every card on
|
||||
Developers and Publishers, were wider than the screen: the counts and the
|
||||
"View all" links were cut off and the page slid sideways. One long name was
|
||||
enough, because a grid with no column count for small screens grows to fit
|
||||
its longest line. Every grid now starts at one column that fits the screen,
|
||||
and a test fails on any grid that does not.
|
||||
- **Game names are back in the leaderboards.** Top Online, Top Offline and the
|
||||
developer and publisher pages squeezed the name to nothing to make room for
|
||||
the genre badge and the review score. On a phone those two now give way to
|
||||
the name.
|
||||
- **The Android app keeps out from under the status bar.** Since 2.0.0 the top
|
||||
bar sat under the clock and the battery icon: the safe-area padding the 1.x
|
||||
app had was lost in the rewrite. The page, the menu, the dialogs, the
|
||||
back-to-top button and the notifications clear the status and navigation
|
||||
bars again, and a strip behind the status bar keeps the clock readable
|
||||
whichever theme the app and the phone are in. This needs Android System
|
||||
WebView 136 or newer, which any phone that updates it from the Play Store
|
||||
has.
|
||||
- **Charts that fit.** On a phone the Anti-Cheat, Delisted and Catalogue
|
||||
growth legends no longer cover the chart, axis numbers no longer print on
|
||||
top of each other, and the tag cloud shows the most common tags instead of
|
||||
dropping exactly those.
|
||||
- **Smaller fixes.** The header search shows its hint instead of "Search by
|
||||
na"; on /games a game with a long anti-cheat name no longer paints over the
|
||||
next card; the consent gate scrolls to its top on a short screen; long
|
||||
names and links in titles and game descriptions wrap instead of widening
|
||||
the page.
|
||||
|
||||
## ⚡ Faster repeat visits
|
||||
|
||||
- **Static files are cached by what they are.** Only the hashed scripts,
|
||||
styles and fonts had a lifetime; the icons, the favicon, the social card,
|
||||
the manifest and Workbox's runtime were asked for again on every page load.
|
||||
Workbox's hashed runtime is now cached for a year like the rest of the
|
||||
build, and the art and manifest are fresh for a day and then refreshed in
|
||||
the background. Pages, the service worker and the version signal still
|
||||
revalidate every time, so a deploy - or a changed legal document - shows
|
||||
on the next load.
|
||||
- **Game art comes straight out of Cloudflare's cache.** Every thumbnail and
|
||||
hero ran the site's Worker on every view, however often it had been seen -
|
||||
a Worker always runs before the cache. The website now loads the AVIF
|
||||
copies from the site's own image host, `media.free-steam-games.win`, which
|
||||
Cloudflare caches like any static file, and falls back to the old address
|
||||
by itself for art the cron has not converted yet or a browser without AVIF.
|
||||
The desktop and Android apps are unchanged. The Privacy Policy now names the
|
||||
image host, so returning visitors see the consent gate once, showing that
|
||||
paragraph.
|
||||
|
||||
## 📚 Docs
|
||||
|
||||
- `docs/DEPLOYMENT.md` explains which commits deploy: documentation commits
|
||||
stopped deploying, data commits still did, and it gives a configuration that
|
||||
stops both - with the one trap: the legal documents are read by the build,
|
||||
so a commit that changes only them must still trigger one.
|
||||
- `docs/android-support.md` (and its Vietnamese mirror) says which Android
|
||||
System WebView the safe areas need, and what to do on an older one.
|
||||
@@ -0,0 +1,67 @@
|
||||
# v4.2.0 – 2026-10-03 (The "All-Time High" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Every game now shows the most players it has ever had at once, the catalogue
|
||||
the site and the apps keep for offline use is a fraction of its old size and
|
||||
no longer readable as text, and every open dependency alert is closed. Web
|
||||
app + desktop/Android bumped `2.1.1` → `2.2.0`; repo public-facing version
|
||||
`4.1.1` → `4.2.0`.
|
||||
|
||||
On the website all of this is already live. The desktop app offers 2.2.0
|
||||
through its updater once the release is published; on Android, install the
|
||||
new APK over the old one. The apps also pick up the Disclaimer's new
|
||||
paragraph on where player numbers come from, so they show the consent gate
|
||||
once, with that paragraph; the website already did.
|
||||
|
||||
## ✨ Added
|
||||
|
||||
- **All-time peak players.** Every game shows the most players it has ever had
|
||||
at once: "All-time peak" on its page, and a sortable column in the games
|
||||
table and the CSV export. The number is the peak Steam Charts has recorded,
|
||||
which for a game it tracks goes back to the launch, read about once a month
|
||||
per game; for the many small games Steam Charts does not track, it is the
|
||||
most this project's own samples have seen. It only ever goes up. The
|
||||
"(peak N)" beside the player count is gone: it was the highest of our own
|
||||
occasional samples since the last full re-fetch, not a daily or all-time
|
||||
peak, and it read like one. The Disclaimer names the new source, so
|
||||
returning visitors see the consent gate once, showing that paragraph.
|
||||
|
||||
## 🗜️ A smaller, opaque offline cache
|
||||
|
||||
- **The catalogue your browser or app keeps for offline use is now stored as
|
||||
the packed shards it downloads**, not as thousands of readable records:
|
||||
about 1.4 MB instead of roughly 9.5 MB, and opaque bytes in DevTools.
|
||||
Like the packed downloads, this is compression and obfuscation, not
|
||||
protection: the key is public, and the dataset stays readable in Git. The
|
||||
copy an earlier version saved keeps working until the data next changes,
|
||||
then it is replaced and deleted. Same storage keys, so the Privacy Policy
|
||||
and the consent gate are unchanged.
|
||||
- Opening the cached catalogue happens off the main thread now: on a
|
||||
desktop the longest freeze while loading it fell from about 20 ms to 6 ms,
|
||||
for about 45 ms more until the data is ready. The two cache keys are now
|
||||
written in one transaction, so a failed write can no longer leave a new
|
||||
index next to old data, and a cache that will not open is simply
|
||||
downloaded again.
|
||||
|
||||
## 🧰 Pipeline
|
||||
|
||||
- `scripts/refresh_peaks.py` and the daily "Refresh All-Time Peaks" workflow
|
||||
(19:30 UTC) ask Steam Charts about a thirtieth of the catalogue a day, a
|
||||
page every two to three seconds, and stop for the day if it ever refuses;
|
||||
every run also raises the field from the pipeline's own player counts. A
|
||||
manual run with `backfill` ticked asks about every game at once, in about
|
||||
four hours.
|
||||
|
||||
## 🔐 Security
|
||||
|
||||
- **Every open dependency alert is closed** (19 from Dependabot, plus the few
|
||||
`npm audit` adds); `npm audit` reports none. Only two of the packages run in
|
||||
production: `devalue`, whose parser is in the page and the apps (5.9.2 →
|
||||
5.9.4), and `urllib3` in the data pipeline (2.7.0 → 2.8.0). The rest are
|
||||
build and development tools: `undici` comes up to 7.29.1 with wrangler
|
||||
4.147.0, and `brace-expansion`, `fast-uri` and `serialize-javascript` are
|
||||
lockfile-only bumps. SvelteKit 2 still asks for `cookie` 0.6, whose fix is
|
||||
only in SvelteKit 3, so an npm override gives it 0.7.2 (same API; with the
|
||||
static adapter that code only runs while the site is built). The `sharp`
|
||||
override is gone: wrangler's own pin now holds the patched version.
|
||||
@@ -0,0 +1,47 @@
|
||||
# v4.2.1 – 2026-10-10 (The "Age Gate" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Adult Only games now have their tags, languages and paid-DLC flag. Every
|
||||
release date reads the same way, and the catalogue's text no longer carries
|
||||
HTML escapes, invisible characters or Vietnamese notes. Only the data
|
||||
pipeline changed: the web app and the desktop/Android apps stay at `2.2.0`,
|
||||
with no new build. Repo public-facing version `4.2.0` → `4.2.1`.
|
||||
|
||||
The fixes reach the catalogue through the pipeline itself. The next data job
|
||||
rewrites the dates, notes and text once. The next `Refresh Store Data` run
|
||||
fills the games that were empty. Every app, old or new, picks the changes up
|
||||
with its next catalogue download.
|
||||
|
||||
## 🐛 Fixed
|
||||
|
||||
- **Adult Only games had no tags, no languages and the wrong paid-DLC flag.**
|
||||
Steam answers an anonymous visit to such a game's store page with its age
|
||||
check, a Sign In page no cookie gets past, and the pipeline read that page
|
||||
as the game's own: no language table, no tags, no DLC section. 25 games
|
||||
were stuck that way: about 16 adult games, plus Warframe, PUBG, Rainbow Six
|
||||
Siege and other age-rated games that were gated on the US servers the
|
||||
pipeline runs on. Every one of them was marked "no paid DLC". A gated page
|
||||
is now recognised and never read. Those games come from Steam's own store
|
||||
data instead: tags, languages with their interface/audio/subtitle columns,
|
||||
and the paid-DLC flag from the prices of their DLC. A game with empty tags
|
||||
or languages is retried every day until they fill.
|
||||
- **"Point & Click".** 458 games had the tag written out with its HTML
|
||||
escape, next to 10 with "Point & Click", so the tag filter listed both
|
||||
(also "Design & Illustration" and "Animation & Modeling"). About 320
|
||||
descriptions showed `"` instead of quotation marks.
|
||||
- TrackMania Nations Forever listed a language called "#lang_slovakian"; it
|
||||
is Slovak.
|
||||
|
||||
## 🧹 Changed
|
||||
|
||||
- **One release-date format.** Every release date reads like "Aug 21, 2012".
|
||||
The catalogue held three shapes: about 1,360 games in "21 Aug, 2012" and
|
||||
one in Russian. Dates sent in another order or another store language are
|
||||
converted when they are saved. Placeholders such as "Coming soon" are left
|
||||
as they are.
|
||||
- The note "Có DLC trả phí", which the browser extension wrote on 482 games,
|
||||
now reads "Has paid DLC".
|
||||
- Invisible characters (zero-width spaces, stray direction marks) and stray
|
||||
spaces or tabs are removed from 56 games' names, developers, publishers and
|
||||
descriptions. Two games listed a publisher that was only a space.
|
||||
@@ -0,0 +1,87 @@
|
||||
# v4.3.0 – 2026-10-13 (The "Autopilot" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The admin can now approve the review queue on its own, a batch at a time and
|
||||
within a daily limit, and it can take games out of the catalogue and put them
|
||||
back. Four new admin pages show what is going on. Only the admin, its Worker
|
||||
routes and the data pipeline changed: the desktop and Android apps stay at
|
||||
`2.2.0` with no new build, there is no D1 migration, and the GitHub App keeps
|
||||
the same permissions. Repo public-facing version `4.2.1` → `4.3.0`.
|
||||
|
||||
Auto-approve is **off** until it is turned on at `/admin/automation`.
|
||||
|
||||
## ✨ Added
|
||||
|
||||
- **Auto-approve.** Every 15 minutes the Worker's cron can approve one batch
|
||||
of pending games, exactly as a reviewer's Approve does: a request in
|
||||
`scripts/temp_info.jsonl` that the ingest still checks game by game (free,
|
||||
reachable, a game, not already listed). The page sets the limits: games per
|
||||
batch (up to 100), games per day (up to 500, a ceiling written in code), a
|
||||
minimum wait before a game can be taken, the order, and which discovery
|
||||
sources. A batch is committed only when the previous one has been ingested
|
||||
and no data job is running or waiting its turn, since pushing then would
|
||||
cancel that job. Anything it cannot check counts as "not now". **Run one
|
||||
batch now** does one on demand, within the same limits.
|
||||
- **Removing games.** `/admin/remove` takes up to 100 games out of the
|
||||
catalogue at once, with a reason from a fixed list and an optional note.
|
||||
Both are public. A removal is a line in the new `data/blocklist.jsonl`, and
|
||||
every pipeline write leaves those games out. No scrape, re-fetch or
|
||||
browser-extension push can bring one back, and discovery never proposes it
|
||||
again. Each removal is logged once in `scripts/removed_games.jsonl`, so the
|
||||
game's page says it was removed and why. **Restore** puts a game back in one
|
||||
commit, and the game is fetched fresh from Steam. `scripts/delete_game.py`
|
||||
does the same from the command line. It used to be an interactive prompt
|
||||
that kept no record and did not stop the game from coming back.
|
||||
- **Overview** at `/admin`, with one card each for the queue, auto-approve's
|
||||
day, removals waiting for the pipeline, data jobs running now, data-quality
|
||||
totals, and commit jobs that failed or are stuck. The queue moved to `/admin/queue`, and old
|
||||
links are forwarded there.
|
||||
- **Pipeline** (`/admin/pipeline`): the latest runs of every data workflow, and
|
||||
what is running or waiting.
|
||||
- **Data quality** (`/admin/quality`): published games with something missing
|
||||
or unreviewed, such as safety never set or never reviewed, no genre, no tags
|
||||
or no publisher. Each game links to its Edit page.
|
||||
|
||||
## 🐛 Fixed
|
||||
|
||||
- **A free DLC, demo or tool could be added as a game.** The ingest now
|
||||
refuses anything Steam does not call a game, and logs it as `not_a_game`.
|
||||
This applies to the browser extension too.
|
||||
- `ingest_new.py` crashed on an entry whose link was a number, and would have
|
||||
crashed again on every three-hourly run until the file was cleaned by hand.
|
||||
A number is now read as an appid, and anything else unusable is counted as
|
||||
a bad entry.
|
||||
- An ingest run that waited behind a long data job worked on the data as it
|
||||
was when the run was queued. It now starts from the tip of `main`.
|
||||
- `Mark Dead Games` pushed with a bare `git push`, so a commit landing during
|
||||
its run threw the run away. It now commits through the same
|
||||
rebase-and-retry helper as every other data job.
|
||||
|
||||
## 🧰 Pipeline
|
||||
|
||||
- `scripts/remove_games.py` applies the blocklist. `Ingest New Game Links`
|
||||
runs it before every ingest, and a push to `data/blocklist.jsonl` starts that
|
||||
workflow. A save that would remove more than 500 games stops before writing
|
||||
anything, so a damaged file fails loudly instead of emptying the catalogue.
|
||||
`Check Overrides` validates the blocklist on every push that touches it.
|
||||
- Discovery counts removed games as already known.
|
||||
|
||||
## 🔐 Security
|
||||
|
||||
- The app shell's lockfile takes `rustls` 0.23.45 (and `rustls-webpki`
|
||||
0.103.15), closing GHSA-2mjx-qc3c-rqvc: TLS 1.3 handshake messages were
|
||||
accepted across encryption-level boundaries. Only the desktop updater's
|
||||
HTTPS client uses it; the Android app does not include it. The desktop app
|
||||
picks it up in its next build, and 2.2.0 is unchanged.
|
||||
|
||||
## 🧹 Housekeeping
|
||||
|
||||
- 25 merged branches on GitHub, their local copies and 7 stale worktrees are
|
||||
gone. GitHub now deletes a pull request's branch when it is merged.
|
||||
- Dependencies: Tauri 2.12.2 and its plugins (#181), and eleven npm
|
||||
minor/patch updates including Svelte 5.57.2, Vite 8.3.4 and wrangler
|
||||
4.149.0 (#182). The website already runs them; the apps pick them up in
|
||||
their next build. Dependabot no longer proposes SvelteKit 3,
|
||||
adapter-static 4, a new Svelte, Tailwind or TypeScript major, or a
|
||||
`@types/node` ahead of the Node 24 the project runs on.
|
||||
@@ -0,0 +1,78 @@
|
||||
# v4.3.1 – 2026-10-16 (The "Fair Play" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Anti-cheat information comes from Steam again, for every game, and the
|
||||
retired browser extension leaves the repository. Only the data pipeline, the
|
||||
admin, the docs and two legal documents changed: the desktop and Android apps
|
||||
stay at `2.2.0`, with no new build. Repo public-facing version `4.3.0` →
|
||||
`4.3.1`.
|
||||
|
||||
The data catches up through the pipeline itself. The first data job after
|
||||
this release cleans the notes once (about 520 games). The first anti-cheat
|
||||
sweep fills and corrects every game Steam has a declaration for, and every
|
||||
daily sweep after it keeps them in step.
|
||||
|
||||
## 🐛 Fixed
|
||||
|
||||
- **No game added since September had an anti-cheat.** The browser extension
|
||||
was the only part of the project that read the anti-cheat a developer
|
||||
declares on Steam, and it stopped in June; the pipeline itself only looked
|
||||
for VAC. None of the 4,700 games added since then had one, Delta Force's
|
||||
kernel-level ACE included. The pipeline now reads Steam's own declaration:
|
||||
the product, whether it runs in the kernel, and whether it needs Secure
|
||||
Boot. It does so when a game is added, and for the whole catalogue every
|
||||
day. More than 80 games that declare an anti-cheat on Steam had none here,
|
||||
among them Brawlhalla, Destiny 2, THE FINALS, Delta Force, Albion Online,
|
||||
SMITE 2, Throne and Liberty and Dark and Darker; about 20 more get the
|
||||
kernel flag or note they were missing. A developer who types a paragraph
|
||||
where the product name goes gets a label cut to 40 characters, with the
|
||||
whole text kept in the note.
|
||||
- **Where the list and Steam disagree, Steam's declaration wins.** Wuthering
|
||||
Waves uses ACE, not EAC; Jujutsu Kaisen Phantom Parade's anti-cheat does not
|
||||
run in the kernel; Marvel Rivals' kernel flag is now known. A correction
|
||||
made in the admin still beats Steam. A game that declares nothing on Steam
|
||||
keeps what it has, because no declaration is not proof that a game has no
|
||||
anti-cheat (Warframe, Overwatch 2 and NARAKA declare none).
|
||||
- A game whose anti-cheat had been reset to an empty value had only its first
|
||||
Steam category checked for VAC, and a full re-fetch reset `-` to an empty
|
||||
value.
|
||||
|
||||
## ✨ Added
|
||||
|
||||
- **The anti-cheat sweep** (`scripts/refresh_anticheat.py`), at the end of the
|
||||
daily Refresh Store Data run, with a commit of its own. About 160 requests
|
||||
to Steam's store API cover every game; a store page is read only for a
|
||||
declaration whose name the API leaves out. A manual Refresh Store Data run
|
||||
with `only: anticheat` runs just the sweep.
|
||||
|
||||
## 🧹 Changed
|
||||
|
||||
- **The browser extension is archived**
|
||||
([steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension);
|
||||
v2.8.0 was its last release). The ingest queue (`scripts/temp_info.jsonl`)
|
||||
now takes store links only: any other key on a line is ignored, and the game
|
||||
is fetched from Steam. The code that merged the extension's fields is gone,
|
||||
along with the field lists that existed only for it.
|
||||
- The notes the extension left behind are removed: "Has paid DLC" at the
|
||||
start of 491 notes (the paid-DLC flag already says it, and 10 of those notes
|
||||
contradicted the flag) and "[hover-add]" on 26. A note left with nothing
|
||||
else reads "Not reviewed yet".
|
||||
- DISCLAIMER section 5 and Terms of Use item 5 now say where anti-cheat comes
|
||||
from: the developer's declaration on Steam. On the website the consent
|
||||
screen shows those two changes once.
|
||||
- "Denuvo", Steam's name for Denuvo Anti-Cheat, is grouped with it in the
|
||||
charts and filters.
|
||||
|
||||
## 🧰 Pipeline
|
||||
|
||||
- Refresh Store Data checks out the tip of `main` when it starts, as the
|
||||
ingest does, so a run that waited its turn works on current data.
|
||||
- A retired override whose old value equals its new one no longer counts as a
|
||||
change on every save.
|
||||
|
||||
## 📚 Docs
|
||||
|
||||
- README, CONTRIBUTING and the contact page no longer send anyone to the
|
||||
extension. A missing game or a correction goes in Discussions › Ideas, and
|
||||
the manual fork path queues links only.
|
||||
@@ -0,0 +1,24 @@
|
||||
# v4.3.2 – 2026-10-16 (The "Pigeonhole" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The anti-cheat charts and filters know the products Steam's declarations
|
||||
brought in. Only the website's anti-cheat grouping and the pipeline's labels
|
||||
changed: the desktop and Android apps stay at `2.2.0`, with no new build, and
|
||||
group these products from their next release. Repo public-facing version
|
||||
`4.3.1` → `4.3.2`.
|
||||
|
||||
## ✨ Added
|
||||
|
||||
- **Seven more anti-cheat families**: ACE (Anti-Cheat Expert), Anti-Cheat
|
||||
Toolkit, CrackProof, HoYoKProtect, NGS (Nexon Game Security), EA Javelin and
|
||||
SARD. After v4.3.1, 68 of the 159 games with a named anti-cheat sat in the
|
||||
charts' "Other" slice; now 35 do, and those are one-off names a developer
|
||||
typed. New games get the short name as their label; a label already stored
|
||||
stays as it was written, so nothing in the catalogue is rewritten.
|
||||
|
||||
## 🐛 Fixed
|
||||
|
||||
- A product name now has to appear as a whole word to count. Matching inside
|
||||
words would have filed "Space Guard", "Interface Shield" or "Peacekeeper"
|
||||
under ACE, and "Vacuum Protect" under VAC.
|
||||
@@ -0,0 +1,64 @@
|
||||
# v4.3.3 – 2026-10-19 (The "Locksmith" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The one open code-scanning alert is fixed, and what SonarCloud found on
|
||||
`main` is fixed or accounted for: CI installs only what it has pinned and runs
|
||||
no dependency's install code, the Android app stops copying its data into
|
||||
Google's backup, and the parsers lose the regexes that could backtrack.
|
||||
Desktop and Android bumped `2.2.0` → `2.2.1`; repo public-facing version
|
||||
`4.3.2` → `4.3.3`.
|
||||
|
||||
The apps also catch up with the website: the new Contact page, the reworded
|
||||
anti-cheat paragraphs of the Disclaimer and the Terms (so they show the
|
||||
consent gate once, with those paragraphs), and v4.3.2's anti-cheat grouping.
|
||||
The desktop app offers 2.2.1 through its updater once the release is
|
||||
published; on Android, install the new APK over the old one.
|
||||
|
||||
## 🔐 Security
|
||||
|
||||
- **Code scanning is clean again.** The worker that decodes the catalogue now
|
||||
refuses a message from any origin but its own (CodeQL
|
||||
`js/missing-origin-check`). Only the page that started it can reach it, so
|
||||
nothing changes for anyone; the alert had been dismissed once and came back
|
||||
as soon as the code around it moved.
|
||||
- **CI installs only what it has pinned.** The release workflows, which hold
|
||||
the signing keys, pin every third-party action to a commit. Every `npm ci`
|
||||
runs with `--ignore-scripts`, and no workflow uses `npx`. The Python
|
||||
pipeline pins every package it installs, the dependencies' dependencies
|
||||
included, with the hash of each file, and installs wheels only
|
||||
(`--require-hashes --only-binary :all:`), so no package's setup script runs
|
||||
and nothing unlisted is installed.
|
||||
- **The Android app no longer takes part in Android's Auto Backup.** Left
|
||||
unset, Android copied the app's storage (your consent, your settings and
|
||||
the cached catalogue) into your Google account's backup, while the Privacy
|
||||
Policy says none of it leaves your device. From 2.2.1 it stays there; on a
|
||||
new phone you accept the terms again.
|
||||
- The source no longer contains raw invisible or right-to-left control
|
||||
characters: the pipeline's lists of characters to strip spell them as
|
||||
escapes.
|
||||
|
||||
## 🧹 Changed
|
||||
|
||||
- Regexes that could backtrack quadratically on long input are linear now:
|
||||
the store page's tags and "unsupported" language rows, the discovery
|
||||
sweep's search rows, the review percentage and label, the chart colour
|
||||
tokens, the legal pages' titles, the image route's capsule path and a few
|
||||
more. Each new form was checked against the old one, on the dataset and on
|
||||
random input.
|
||||
- Lists sorted for a build hash, the sitemap or a test R2 listing state the
|
||||
code-unit order they always had; the admin stylesheet puts its `@import`s
|
||||
first, as CSS requires (the built stylesheet is byte-for-byte the same);
|
||||
`Number.parseInt` over the global, `[[ ]]` in the bash wrappers; the unused
|
||||
`normalizeLink` is gone; the Steam client mounts its retrying adapter for
|
||||
https only.
|
||||
- New tests pin the store page's tag and language parsing, the discovery
|
||||
sweep's rows, the review summary parsing and the worker's origin check.
|
||||
|
||||
## 📚 Docs
|
||||
|
||||
- `CLAUDE.md`: the worker's origin check, the CI pinning rules (and how to add
|
||||
a Python dependency), the Android backup decision. `docs/dev_env.md` and its
|
||||
Vietnamese copy: run the pipeline from the repo root, with the hashed
|
||||
installs; they said `cd scripts`, from where `data/` cannot be found.
|
||||
`docs/DEPLOYMENT.md`: what CI checks, CodeQL and SonarCloud included.
|
||||
@@ -0,0 +1,97 @@
|
||||
# v4.4.0 – 2026-10-23 (The "Headroom" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The data pipeline grows with the catalogue again. With almost 10,000 games
|
||||
and a few hundred more every day, the jobs that asked Steam about one game at
|
||||
a time had run out of time; they now read Steam's store API fifty games a
|
||||
request, wait their turn instead of cancelling each other, and stop in time to
|
||||
save. The release also carries the tooling merged since v4.3.3 - TypeScript
|
||||
7, Node 26 and Python 3.15, SonarCloud in CI, the desktop updater fix - and a
|
||||
certifi bump. The desktop and Android apps stay at `2.2.1`, with no new
|
||||
build. Repo public-facing version `4.3.3` → `4.4.0`.
|
||||
|
||||
## 🧰 Pipeline
|
||||
|
||||
- **The data jobs scale with the catalogue again.** With almost 10,000 games
|
||||
and a few hundred more every day, three jobs that asked Steam about one
|
||||
game at a time had reached GitHub's six-hour limit: on 2026-10-23 Update
|
||||
Reviews was stopped at exactly six hours with nothing saved. The full
|
||||
assessment, with every measurement, is `docs/plan/18-pipeline-scale.md`.
|
||||
- **Reviews come from Steam's store API, for every game, every day.** Fifty
|
||||
games a request, about two minutes for the catalogue, instead of every two
|
||||
days and five and a half hours. The percentage is now Steam's own, which
|
||||
rounds down: about 4,000 games show one point less once (Counter-Strike 2
|
||||
"85%" instead of "86%"), exactly as on their store pages. A summary that
|
||||
says 0 reviews is double-checked game by game before it replaces a
|
||||
percentage.
|
||||
- **New games get their reviews again.** Steam's per-game reviews endpoint
|
||||
has answered with a redirect to the store front since 2026-10-23, so the 38
|
||||
games added that day were listed with "N/A". A new game now takes its
|
||||
summary from the store API when that endpoint gives none, and a game never
|
||||
read becomes "No reviews" until Steam counts its first one.
|
||||
- **The daily purge needs two answers to remove a game.** Steam's store API
|
||||
screens every game in a few minutes, and a game is removed only when
|
||||
appdetails agrees; "unavailable" is asked twice, five minutes apart. A run
|
||||
that would remove more than 100 games, or flags more than 500, stops before
|
||||
writing anything. It also lists earlier removals that Steam has since
|
||||
undone. It runs daily now, instead of a five-hour sweep on Mondays.
|
||||
- **Check Dead Links is retired.** In its whole life it never found a dead
|
||||
link: Steam sends a delisted game's page to the store front, which answers
|
||||
200. The purge's screen sees delisted games (`unlisted`) instead.
|
||||
- **No run is cancelled for waiting.** The data jobs share one queue that
|
||||
used to hold a single waiting run: a third job cancelled it, and Update
|
||||
Reviews lost five of ten runs that way. The queue now holds them all, first
|
||||
in, first out, and every job checks out the latest `main` when it starts -
|
||||
Auto Update JSON failed four days in ten from working on the data as it was
|
||||
when the run was queued.
|
||||
- **Every long job stops in time to save.** Each workflow gives its job a time
|
||||
budget below its timeout: past it the job saves and commits what it did
|
||||
instead of being stopped with nothing, and it warns before the budget gets
|
||||
tight. The leaderboards skip the pauses meant for store pages (Top Online
|
||||
~27 minutes instead of 48). The store-data and all-time-peak rotations
|
||||
stretch their cycle as the catalogue grows instead of their daily runs.
|
||||
- **Force Re-fetch runs in parts** (`1/8` … `8/8`, queued one after another),
|
||||
and a game whose fetch fails keeps its old data.
|
||||
|
||||
## 🧰 Tooling
|
||||
|
||||
- **Desktop releases keep reaching the updater.** tauri-action v1 writes each
|
||||
file's API address into `latest.json`, which the app's update check refuses,
|
||||
so desktop 2.2.1 had to be fixed by hand before installed apps were offered
|
||||
it. A new step of the release workflow now rewrites those addresses to the
|
||||
release's own downloads, checking every signature on the way.
|
||||
- **SonarCloud reads tests as tests**, and no longer analyses the dataset,
|
||||
the Android resources the Tauri CLI generated, or the SQLite migrations its
|
||||
PL/SQL analyser misread.
|
||||
- **SonarCloud analyses in CI.** A workflow runs the scan on pull requests and
|
||||
on `main` in place of SonarCloud's automatic analysis, with its settings in
|
||||
`sonar-project.properties` (formerly `.sonarcloud.properties`). Commits that
|
||||
only carry data are not scanned. It runs both test suites with coverage
|
||||
first (pytest-cov for the pipeline, `npm run test:coverage` for the web
|
||||
app), so SonarCloud shows what the tests reach instead of reading 0%.
|
||||
- **TypeScript 7, Node 26 and Python 3.15.** The type-check runs on
|
||||
TypeScript 7, the native compiler: `tsc` for the Worker, the tests and the
|
||||
admin's Node code, and `svelte-check --tsgo` for the app. TypeScript 6 stays
|
||||
installed beside it, because svelte-check and SvelteKit's route types still
|
||||
need the JavaScript API that 7.0 does not have (the admin's svelte-check
|
||||
stays on it too). CI, the release builds and Cloudflare's build run Node 26,
|
||||
the LTS from 28 October; the pipeline, its tests and every data job run
|
||||
Python 3.15, which writes the shards byte for byte as 3.12 did - no
|
||||
re-download for anyone. The leaderboards and the dead-link log name their
|
||||
encoding, so they no longer crash on Windows under an older Python. A new
|
||||
test fails when one of the version pins drifts from the others, and Web CI
|
||||
now runs on workflow-only changes so it sees them. The full assessment is in
|
||||
`docs/plan/16-toolchain-2026.md`; `docs/plan/17-typescript-7.1.md` prepares
|
||||
the move to TypeScript 7 alone once 7.1 is out.
|
||||
|
||||
## 🔐 Security
|
||||
|
||||
- **certifi 2026.10.19** (GHSA-6q48-6c7w-9gw2), the CA bundle behind every
|
||||
HTTPS request the pipeline makes. eMudhra's `emSign ECC Root CA - G3` had
|
||||
intermediates whose private keys were compromised; certifi 2026.10.18 - the
|
||||
version pinned here - had already dropped every emSign root, and 2026.10.19
|
||||
puts back the three that are not affected (G1, C1, ECC C3) while G3 stays
|
||||
out. So the pipeline was never trusting the bad root, but the advisory's
|
||||
range covered 2026.10.18 and pip-audit flagged it; the lock now names the
|
||||
fixed release, with its hashes.
|
||||
@@ -0,0 +1,55 @@
|
||||
# v4.4.1 – 2026-10-26 (The "Tune-Up" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
A dependency and security pass. The desktop and Android apps take the
|
||||
patched TLS stack their updater talks to the release server with; the dev
|
||||
tooling, the Python pipeline and the CI workflows catch up with their
|
||||
fixes. Nothing changes in how the site or the apps look or behave. Desktop
|
||||
and Android bumped `2.2.1` → `2.2.2`; repo public-facing version `4.4.0` →
|
||||
`4.4.1`. The desktop app offers 2.2.2 through its updater once the release
|
||||
is published; on Android, install the new APK over the old one.
|
||||
|
||||
## 🔐 Security
|
||||
|
||||
- **The apps' TLS stack is patched.** rustls 0.23.46 closes four advisories,
|
||||
among them an unauthenticated ServerHello that could downgrade later
|
||||
connections to classical key exchange; rustls-webpki 0.103.16 and
|
||||
webpki-root-certs 1.0.11 stop accepting certificates chained to the
|
||||
distrusted emSign intermediates. In the apps this is the HTTPS the updater
|
||||
checks for, and downloads, a new version over.
|
||||
- Also in the apps: tokio, anyhow and event-listener (soundness fixes) and
|
||||
plist 1.10, whose quick-xml 0.42 closes two denial-of-service advisories.
|
||||
Still waiting on Tauri: the zip 4 inside its updater plugin (three
|
||||
extraction advisories; the updater checks every download's signature
|
||||
before it opens it), the Linux GTK 3 bindings (glib 0.18) and the
|
||||
unmaintained proc-macro-error, zbus_names and zvariant. They go when Tauri
|
||||
moves.
|
||||
- Dev tooling: undici 7.30.1 inside wrangler's local simulator (three
|
||||
advisories; it runs in `wrangler dev` and the deploy check, never in the
|
||||
deployed Worker), zod 4.6.7 (in the unused-code report).
|
||||
- Two SvelteKit advisories are fixed only in SvelteKit 3 and need code this
|
||||
site does not have - a prerendered page forwarding an untrusted
|
||||
`cache-control` to `setHeaders`, and `use:enhance` form actions - so they
|
||||
are dismissed as not applicable. The move to SvelteKit 3 is a migration of
|
||||
its own.
|
||||
|
||||
## 🧹 Changed
|
||||
|
||||
- Pipeline: certifi 2026.10.23 (the CA bundle the scrapers verify Steam
|
||||
with), coverage 7.17.0 for the tests, both pinned with their hashes.
|
||||
- Site and apps: bits-ui 2.20.2, Lucide 1.61.0, TanStack Virtual 3.13.48,
|
||||
Vite 8.3.5; tooling: wrangler 4.152.0, knip 6.43.0, Tauri CLI 2.12.4.
|
||||
- Merged by Dependabot since v4.4.0 and first shipped in these apps: Tauri
|
||||
2.12.4; in the build tooling, fast-uri 3.1.9 and serialize-javascript 7.1.4
|
||||
(two advisories).
|
||||
- CI: every workflow runs on `actions/checkout` v6 and `actions/setup-python`
|
||||
v6. The data jobs still on the Node 20 majors printed a deprecation warning
|
||||
on every run. The release workflows take rust-cache 2.9.3.
|
||||
|
||||
## 📚 Docs
|
||||
|
||||
- `CLAUDE.md`: the undici override and when to delete it; why SvelteKit
|
||||
stays on 2 and what would make the two advisories apply again.
|
||||
`.github/dependabot.yml`: why checkout and setup-python majors are taken by
|
||||
hand, for every workflow at once.
|
||||
@@ -0,0 +1,38 @@
|
||||
# v4.5.0 – 2026-10-26 (The "Groundwork" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The site and the apps move to SvelteKit 3, the framework every page is
|
||||
built on. Nothing about how they look or work should change: every page,
|
||||
the Content-Security-Policy and the offline cache were compared with a
|
||||
SvelteKit 2 build of the same commit before the switch. The apps also take
|
||||
Tauri 2.12.5. Desktop and Android bumped `2.2.2` → `2.3.0`; repo
|
||||
public-facing version `4.4.1` → `4.5.0`. The desktop app offers 2.3.0
|
||||
through its updater once the release is published; on Android, install the
|
||||
new APK over the old one.
|
||||
|
||||
## 🧹 Changed
|
||||
|
||||
- **The site and the apps build on SvelteKit 3** (3.1, with adapter-static
|
||||
4). Nothing changes for readers: the same pages with the same text, the
|
||||
same Content-Security-Policy and the same service-worker precache, each
|
||||
checked against a SvelteKit 2 build of the same commit. SvelteKit 3 refuses
|
||||
`svelte.config.js`, so its options moved to `web/build/sveltekit-config.ts`,
|
||||
now with tests for both the web and the app policies; `$lib` imports became
|
||||
`#lib`, and the `/legal/<slug>` matcher moved to `web/src/params.ts`.
|
||||
- The service worker is wired into the build by `web/build/pwa.ts`, on
|
||||
vite-plugin-pwa: `@vite-pwa/sveltekit` never supported SvelteKit 3.
|
||||
- An old `/#/…` link to a page that no longer exists now opens the "Page not
|
||||
found" page (`/error/404`); SvelteKit 3 refuses to navigate to it in place.
|
||||
One that names another site (`/#//other.example/…`) is ignored.
|
||||
- SvelteKit now asks the site for its version (`/_app/version.json`, a few
|
||||
bytes) when a tab regains focus and once an hour, where it used to ask only
|
||||
after a navigation failed. A newer deploy still changes nothing until a
|
||||
navigation fails, which then reloads the page, as before.
|
||||
- The desktop and Android apps take Tauri 2.12.5 (tauri-build 2.7.4).
|
||||
|
||||
## 🔐 Security
|
||||
|
||||
- The two SvelteKit advisories dismissed in v4.4.1 (GHSA-27mw-82g8-phjj,
|
||||
GHSA-pfhg-q3qv-9q6r) are fixed by the upgrade, and `npm audit` reports
|
||||
nothing: the `cookie` override SvelteKit 2 needed is gone.
|
||||
@@ -0,0 +1,43 @@
|
||||
# v4.5.1 – 2026-10-27 (The "Speed Bump" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The site's Worker now limits how fast one address can call it, behind
|
||||
Cloudflare's own rate-limiting rule at the edge. Nothing changes for readers,
|
||||
the apps or the pipeline: every limit sits far above what they send. The
|
||||
desktop and Android apps stay at `2.3.0`, with no new build. Repo
|
||||
public-facing version `4.5.0` → `4.5.1`.
|
||||
|
||||
## 🔐 Security
|
||||
|
||||
- **Rate limits in the Worker, one budget per surface.** Per address and per
|
||||
minute: the catalogue API 240 requests (loading the whole catalogue takes
|
||||
about 16), the image proxy 600, the other public API routes 120, the human
|
||||
check 20 (a person sends one a day) and the admin surface 300. Past a limit
|
||||
the Worker answers `429 Too Many Requests` with `Retry-After: 60` until the
|
||||
minute is up; the apps can read that answer, where they would otherwise have
|
||||
seen a network error. An IPv6 address counts by its /64, the block one
|
||||
subscriber is normally given. Cloudflare keeps these counts per server, so
|
||||
they stop a client that keeps its connection open, as browsers and most
|
||||
scripts do; one that reconnects for every request is left to the edge rule,
|
||||
which counts exactly. They are ceilings for abuse, never quotas. The limits
|
||||
are bindings in `web/wrangler.jsonc` and change by pull request.
|
||||
- **Two layers, the edge first.** The zone's rate-limiting rule still refuses
|
||||
a burst before the Worker runs, at no cost, and is the only limit on the
|
||||
pages themselves; the Worker adds the one-minute window the Free plan's
|
||||
10-second rule cannot, and keeps holding if that rule is changed. If the
|
||||
Worker's limiter is ever unavailable, requests go through rather than fail.
|
||||
- The recommended edge rule now covers the whole site except the hashed
|
||||
JavaScript and CSS bundles, at 250 requests per 10 seconds per address. That
|
||||
is about twice what a first visit sends once the offline cache fills in
|
||||
(counted from the build: 110 to 130 requests in a few seconds). Applying it
|
||||
is a Cloudflare dashboard change, described in `docs/SECURITY_SETUP.md` §3a.
|
||||
|
||||
## 📚 Docs
|
||||
|
||||
- `docs/SECURITY_SETUP.md` §3 describes both layers, how to check each one
|
||||
with `curl`, and the Free-plan rule budget as it stands (one of one rate
|
||||
limiting rule, four of five custom rules).
|
||||
- `CLAUDE.md` records the layer's rules: it fails open, is not logged, keeps a
|
||||
60-second period and an account-unique `namespace_id` per binding, and needs
|
||||
a budget for any prefix the Worker runs first for.
|
||||
@@ -0,0 +1,67 @@
|
||||
# v4.6.0 – 2026-10-30 (The "Polyglot" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
The catalogue now takes free games in every language, not only the ones
|
||||
that support English: about 1,300 more, most of them Chinese, Japanese or
|
||||
Korean, arrive through the review queue over the next days. The site and
|
||||
the apps get a language filter, search that matches across scripts and
|
||||
widths, and CSV files that Excel opens correctly; and 1,357 games filed under
|
||||
"Free To Play" get a real genre. Desktop and Android
|
||||
bumped `2.3.0` → `2.4.0`; repo public-facing version `4.5.1` → `4.6.0`.
|
||||
The desktop app offers 2.4.0 through its updater once the release is
|
||||
published; on Android, install the new APK over the old one.
|
||||
|
||||
## ✨ Added
|
||||
|
||||
- **Games in every language.** Discovery used to search Steam only for free
|
||||
games that list English, which left out 1,592 of them: mostly Simplified
|
||||
Chinese (784), Japanese (317), Korean (165) and Traditional Chinese (164)
|
||||
only, the free Japanese visual novel `//トロイメライ・ノクターン` among them.
|
||||
It now proposes every free game whatever its languages, and every release
|
||||
window swept before gets one more pass. The pipeline still asks Steam in English, so
|
||||
tags, genres and language names stay in English; a name or description the
|
||||
developer never wrote in English stays in their language.
|
||||
- **A language filter on Games**, counted like the others and part of the
|
||||
link (`?lang=Japanese`), so a reader can keep to the languages they read.
|
||||
The About page says the catalogue now covers every language.
|
||||
- **Search across scripts and widths.** Every search box (Games, the command
|
||||
palette, developers, publishers and the anti-cheat list) now matches
|
||||
half-width and full-width forms and hiragana and katakana as one: `トロイ`,
|
||||
`とろい` and `トロイ` find the same game, and `4` finds `4`. One kanji, kana
|
||||
or Hangul syllable is enough in the command palette.
|
||||
- `/admin` shows a candidate's languages, with a **No English** badge when
|
||||
English is not among them. Such games are decided like any other.
|
||||
|
||||
## 🐛 Fixed
|
||||
|
||||
- The header search no longer jumps to Games in the middle of a word typed
|
||||
with a Japanese, Chinese or Korean input method; it waits until the word is
|
||||
chosen. And it keeps its focus when it does jump: until now the next letter
|
||||
typed after the jump went nowhere, whatever the language.
|
||||
- A CSV export opens in Excel with its Japanese, Chinese and Korean names
|
||||
intact (it now starts with a byte order mark).
|
||||
- A long Chinese or Japanese description is cut at the end of a sentence
|
||||
where it can be, and never ends in `、…` or `。…`.
|
||||
- **"Free To Play" is no longer a genre.** Steam spells it with a capital T,
|
||||
the list of names never to use as a genre had a small one, and 1,357 games
|
||||
were filed under "Free To Play" - the third most common genre, and one that
|
||||
says nothing about a catalogue of free games. New games get their real
|
||||
genre, and the daily store refresh gives the 1,357 theirs from Steam, 150 a
|
||||
day (about nine days). A genre someone set by hand is never touched.
|
||||
- A queued store link written in full-width digits (`5118700`) is read
|
||||
as the appid it is; digits of any other script are refused. Such an appid
|
||||
used to slip through, and the next daily refresh would have stopped on it.
|
||||
The blocklist now accepts exactly the lines the site's own reader does.
|
||||
|
||||
## 🧰 Pipeline
|
||||
|
||||
- Discovery runs wait in turn: backfill windows dispatched together no longer
|
||||
cancel each other, and a window can be swept a whole year at a time
|
||||
(`max_pages`). Each run says how many candidates do not list English.
|
||||
|
||||
## 📚 Docs
|
||||
|
||||
- `docs/plan/19-all-languages.md`: what kept these games out, what every
|
||||
workflow does with them, and what is left (games not sold in the US, CJK
|
||||
fonts).
|
||||
@@ -0,0 +1,39 @@
|
||||
# v4.6.1 – 2026-10-31 (The "Zip Tie" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
A security pass. The desktop app's updater takes the patched zip reader
|
||||
v4.4.1 had to leave waiting on Tauri, and the service-worker build takes
|
||||
patched glob and minimatch. Nothing
|
||||
changes in how the site or the apps look or behave. Desktop and Android
|
||||
bumped `2.4.0` → `2.4.1`; repo public-facing version `4.6.0` → `4.6.1`.
|
||||
The desktop app offers 2.4.1 through its updater once the release is
|
||||
published; on Android, install the new APK over the old one.
|
||||
|
||||
## 🔐 Security
|
||||
|
||||
- **The desktop updater's zip reader is patched.** tauri-plugin-updater
|
||||
2.14.1 moves from zip 4 to zip 9.2, which closes six advisories in how an
|
||||
archive is read and extracted, one of them critical: two headers in one
|
||||
archive that disagree, so whatever checks an archive and whatever unpacks
|
||||
it could see different files. The others are symlinks pointing out of the
|
||||
destination, setuid bits and permissions carried through symlinks, an
|
||||
unbounded symlink target, and an AES entry accepted without its
|
||||
authentication code. The updater opens a zip only on Windows, and only
|
||||
after it has checked the download's signature, so a forged archive never
|
||||
reached it. Still waiting on Tauri: the Linux GTK 3 bindings (glib 0.18) and the unmaintained
|
||||
proc-macro-error, zbus_names and zvariant.
|
||||
- Build tooling: glob 14.0.3 and minimatch 11.0.3 in the service-worker
|
||||
build, two moderate advisories published on 2026-10-30 (an aborted walk
|
||||
that kept reading directories, and patterns that could take exponential
|
||||
time). Only this repository's own patterns reach them, at build time; the
|
||||
service worker precaches exactly the same 172 URLs as before.
|
||||
- deepmerge, used by the Svelte and rollup plugins to merge their own
|
||||
configuration at build time, has a low advisory with no fixed release. It
|
||||
never ships to the site, the Worker or the apps, and the alert is
|
||||
dismissed as a tolerable risk.
|
||||
|
||||
## 📚 Docs
|
||||
|
||||
- `CLAUDE.md`: the glob and minimatch overrides, why they are safe and when
|
||||
to delete them; the undici override can go with wrangler 4.156.0.
|
||||
@@ -0,0 +1,55 @@
|
||||
# v4.7.0 – 2026-11-03 (The "Lucky Dip" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
Two small additions. A Random games page picks up to five games from the
|
||||
catalogue when you cannot decide what to play, and the first-run terms screen
|
||||
gets a way out: on the website, "Leave site" takes you back to the page you
|
||||
came from; in the apps, Decline now quits, which on Android it never did. No
|
||||
legal document changed, so nobody is asked to accept the terms again. Desktop
|
||||
and Android bumped `2.4.1` → `2.5.0`; repo public-facing version `4.6.1` →
|
||||
`4.7.0`. The desktop app offers 2.5.0 through its updater once the release is
|
||||
published; on Android, install the new APK over the old one.
|
||||
|
||||
## ✨ Added
|
||||
|
||||
- **Random games.** `/random`, in the sidebar, the menu and the command
|
||||
palette, with a dice button on the dashboard, rolls one to five games (five
|
||||
to start with): online, offline or either, dead games only when you ask for
|
||||
them, and never one marked unsafe. Roll again for a set that avoids the
|
||||
games on screen; a smaller count keeps the first ones, a larger one adds to
|
||||
them. Opening a game and coming back keeps the picks, and nothing is
|
||||
stored: a reload rolls anew.
|
||||
- **Leave site**, on the first-run terms screen and on the notice after
|
||||
Decline (website only). A page may not open the browser's own start page,
|
||||
so it goes back to the page before the site - the new-tab page when you
|
||||
typed the address there, the search results when you came from a search -
|
||||
past every page of the site you opened in between. When the site is the
|
||||
first page in its tab, it says so and offers to close the tab; that takes a
|
||||
second click, because closing the last tab closes the browser window too.
|
||||
|
||||
## 🐛 Fixed
|
||||
|
||||
- Declining the terms quits the Android app. It did nothing at all: the app
|
||||
asked its window to close, which does nothing on Android. Both apps now quit
|
||||
through Tauri's own exit, and the declined notice appears if an app is ever
|
||||
still open afterwards. The apps also drop a permission nothing uses any more
|
||||
(closing a window from script) for the one quitting needs.
|
||||
|
||||
## 🧰 Tooling & misc
|
||||
|
||||
- Dependencies: SvelteKit 3.1.1 and adapter-static 4.0.1, Svelte 5.57.3,
|
||||
the Tauri shell plugin 2.6.0 (JavaScript and Rust together) and
|
||||
single-instance 2.5.5, the updater's JavaScript side 2.14.1 (its Rust side
|
||||
already was), wrangler 4.156.0, pytest 9.2.0 and the SonarCloud scan
|
||||
action 8.4.0, plus patch releases of the icon, toast and virtual-list
|
||||
libraries. No security advisory among them; nothing changes in how the
|
||||
site or the apps behave.
|
||||
- The undici override is gone: wrangler 4.156.0's local simulator pins the
|
||||
patched undici 7.30.1 itself.
|
||||
|
||||
## 📚 Docs
|
||||
|
||||
- `CLAUDE.md`: how `/random` rolls and why it stores nothing; how Leave site
|
||||
finds the page before the site, and why Decline quits through `exit()`.
|
||||
- Both READMEs list the random page and its modules.
|
||||
@@ -0,0 +1,99 @@
|
||||
# v4.7.1 – 2026-11-09 (The "Curb Cut" Edition)
|
||||
|
||||
[All versions](../../../CHANGELOG.md)
|
||||
|
||||
An accessibility release. The repository gains an accessibility statement
|
||||
that says honestly what works with a keyboard, a screen reader and zoom, and
|
||||
what does not yet. The worst barriers it found are fixed:
|
||||
- the games table is a real table to a screen reader;
|
||||
- the first-run screens hold the keyboard focus;
|
||||
- kernel-level anti-cheat is no longer told apart by colour alone;
|
||||
- both themes meet the contrast WCAG asks for;
|
||||
- the desktop app zooms.
|
||||
|
||||
Like a curb cut, most of it helps everyone. The community docs were also
|
||||
brought back in line with the repository. No legal document you accept
|
||||
changed, so nobody is asked to accept the terms again.
|
||||
|
||||
Desktop and Android go from `2.5.0` to `2.5.1`, and the repo's public version
|
||||
from `4.7.0` to `4.7.1`. The desktop app offers 2.5.1 through its updater once
|
||||
the release is published. On Android, install the new APK over the old one.
|
||||
|
||||
## ✨ Added
|
||||
|
||||
- **An accessibility statement.** `ACCESSIBILITY.md` says what works today
|
||||
with a keyboard, a screen reader and zoom, and what does not work yet: the
|
||||
games table, most charts, the first-run screens, zoom in the apps. It also
|
||||
lists which browsers and apps are checked by hand, and how a report is
|
||||
handled. GitHub shows it as the repository's Accessibility tab. Barriers get
|
||||
their own issue form and an `accessibility` label, and the About page links
|
||||
the statement and the form.
|
||||
- A pull request template covering what and why, the checks to run, and a
|
||||
short accessibility list for interface changes.
|
||||
|
||||
## 🐛 Fixed
|
||||
|
||||
- The About page's stack list said SvelteKit 2 and counted 3,600 rows. Its
|
||||
footnote said everything the page loads comes from this site, which is not
|
||||
true of Cloudflare's beacon and human check. It now says what is true: the
|
||||
game data and art come from this site. The Vietnamese AI note gains the
|
||||
sentence it was missing.
|
||||
- Source archives (`git archive`, GitHub's "Source code" downloads) left out
|
||||
three legal documents that the web build reads, so building from one
|
||||
stopped. They are included now.
|
||||
- **Accessibility**, on the website and in the apps from 2.5.1:
|
||||
- **The games table** is now a table to a screen reader. It exposes its
|
||||
roles, the row and column counts, and a position for every row, even
|
||||
though only the rows on screen exist. The image, data-issue and Steam
|
||||
columns have names.
|
||||
- **Table rows** are no longer a link wrapped around another link, and each
|
||||
row is one <kbd>Tab</kbd> stop instead of two. Clicking anywhere on a row
|
||||
still opens the game.
|
||||
- **The phone cards** are a list that tells a screen reader its length and
|
||||
each card's position.
|
||||
- **The terms screen and the human check** are dialogs that take focus, and
|
||||
the page behind them is out of reach until you are through. Before, Tab
|
||||
walked through the hidden page first, and Ctrl/⌘+K could open the
|
||||
command palette underneath them, out of sight but holding focus.
|
||||
- **Kernel-level anti-cheat** shows a shield icon and the words, not only a
|
||||
red badge.
|
||||
- **Contrast:**
|
||||
- Light-theme links, primary buttons, warnings and badges reach 4.5:1.
|
||||
The light theme's amber is a shade darker as a result.
|
||||
- Red badges in the dark theme reach 4.5:1 too.
|
||||
- Text boxes and drop-downs have a visible 3:1 edge in both themes.
|
||||
- **Zoom:**
|
||||
- The games list keeps a minimum height when zoomed in, instead of
|
||||
shrinking to nothing at 300-400%.
|
||||
- The desktop app zooms with Ctrl/⌘ and + / −.
|
||||
- **Smaller fixes:**
|
||||
- "Back to top" is out of the Tab order while it is hidden, and jumps
|
||||
instead of gliding when *reduce motion* is on.
|
||||
- The command palette's search box shows a focus ring.
|
||||
- Screen readers read out the 💀 and the table's warning icon as words.
|
||||
- `ACCESSIBILITY.md` moves all of this from "Known limitations" to "What
|
||||
works today".
|
||||
|
||||
## 🧰 Tooling & misc
|
||||
|
||||
- `web/src/lib/a11y.test.ts` holds those fixes in the code. It also computes
|
||||
the theme's contrast with the WCAG formula, so a colour edit that drops
|
||||
below 4.5:1 for text, or below 3:1 for a control's edge, fails the tests.
|
||||
|
||||
## 📚 Docs
|
||||
|
||||
- The community docs match the repository again:
|
||||
- **README:** live game-count and version badges, SvelteKit 3, every desktop
|
||||
package, the shard layout, the workflows its table left out, and which
|
||||
commits deploy.
|
||||
- **SECURITY.md:** the real stack, pushes with the built-in token, and the
|
||||
media host and the ingest and update endpoints in scope.
|
||||
- **AUTHORS.md, `username.txt`, CONTRIBUTING.md and the code of conduct.**
|
||||
- **The issue forms:** the hash links, GitHub Pages permalinks and the
|
||||
editing and GPG options are gone. The version is under the title, not
|
||||
behind a hover.
|
||||
- **`web/README.md`, `docs/dev_env.md` (EN + VI), the acknowledgements and
|
||||
the contact page.** Neither of the last two is a document you accept, so
|
||||
nobody is asked to accept the terms again.
|
||||
- `CLAUDE.md`: `ACCESSIBILITY.md` is a claim about the code, kept true in the
|
||||
same pull request, and the rules behind the accessibility fixes.
|
||||
Loaded 100 of 387 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user