title: Implement Frontend Settings

description: Create settings page for managing feeds/categories.

type: task

status: closed


title: docker compose fails

description:
When running docker compose up I got the following error:
[2/3] STEP 1/9: FROM golang:1.23-bullseye AS backend-builder
Resolved "golang" as an alias (/etc/containers/registries.conf.d/000-shortnames.conf)
Trying to pull docker.io/library/golang:1.23-bullseye...
Getting image source signatures
Copying blob sha256:bb30cea4afcbc0a0405508119c28d87afb4518e3558e2f1fb0a52a0498994287
Copying blob sha256:a9acb5a6634ff8f020bd4562c483cdd83503103d2c080d87e777643b57123e41
Copying blob sha256:b26972d9a448e4dba0ac85216372d6ee52bc89839590b4e97f94b77ced5571fe
Copying blob sha256:b1efd17e5717172aa4463c9c599bce51a6939b602dbb135bf6c26d672a6e7496
Copying blob sha256:6a887974b056452b76229e3392cbf8513e741cd3dcd1f05e7397eea6fce361a0
Copying blob sha256:382d65ac76ebcbc7ba7ee0d232ae7afbec48e2b3b673983ac8ced522dabe3abb
Copying blob sha256:4f4fb700ef54461cfa02571ae0db9a0dc1e0cdb5577484a6d75e68dc38e8acc1
Copying config sha256:6f1643fb9acc4fc0b9bf95efd1b4b1cd274dcd73a39cc99ef57da203d7088f42
Writing manifest to image destination
[2/3] STEP 2/9: RUN go install github.com/GeertJohan/go.rice/rice@latest
go: downloading github.com/GeertJohan/go.rice v1.0.3
go: downloading github.com/GeertJohan/go.incremental v1.0.0
go: downloading github.com/akavel/rsrc v0.8.0
go: downloading github.com/daaku/go.zipexe v1.0.2
go: downloading github.com/jessevdk/go-flags v1.4.0
go: downloading github.com/nkovacs/streamquote v1.0.0
go: downloading github.com/valyala/fasttemplate v1.0.1
go: downloading github.com/valyala/bytebufferpool v1.0.0
--> 181d1254149e
[2/3] STEP 3/9: WORKDIR /app
--> 3f497307e2ca
[2/3] STEP 4/9: COPY go.mod go.sum ./
--> 339c24ca12cd
[2/3] STEP 5/9: RUN go mod download
go: go.mod requires go >= 1.24.2 (running go 1.23.12; GOTOOLCHAIN=local)
Error: building at STEP "RUN go mod download": while running runtime: exit status 1

type: bug


title: refactor backend to have a clean API

description:
create a nice clean API for the backend GO code that is more independent of the frontend

ensure that it is working with good tests


title: Increase Test Coverage to >80%

description: Project-wide test coverage is currently ~63%. Key gaps are in the new  and  packages, as well as some core model logic. Increase coverage to at least 80% to ensure stability.


title: Mobile Layout Verification for New Frontend

description: Verify and adjust the new fixed-width layout for mobile devices to ensure responsiveness.


title: delete vanilla js prototype

description: remove it, let's just focus on the react version. make sure everything still builds cleanly, etc after removing. remove any old tests for it, etc.


title: Install golangci-lint in dev environment

description: Local Makefile uses 'go vet' because 'golangci-lint' is missing. CI uses golangci-lint. We should install it locally for consistency.


title: terminal UI

description: once there is good test coverage and a clean backend API, work on a nice efficient TUI with https://github.com/charmbracelet/bubbletea


title: Vanilla JS: Add Feed UI

description: Add UI to add a new feed by URL in vanilla JS prototype.

type: feature


title: reach parity between vanilla js and react v2 ui

description: Continue implementing the vanilla js one with minimal overhad/depdnencies to be fast and lean. Make sure there are tests and rely on the v2 ui and legacy version as references.

type: epic


title: Refactor E2E tests to use page objects

description: The E2E tests are getting complex. Refactor them to use the Page Object Model pattern for better maintainability.


title: v3 feed management

description:
there's no way to delete or add a tag to a feed right now
let's add that to the settings page to start.


title: Seed full_content in benchmarks to measure real payload savings

description: The stream benchmark seeds items without full_content, so B/op doesn't reflect the real-world improvement from excluding full_content. Add seeded full_content to benchmark items so we can quantify the actual memory/payload savings.

status: open


title: run the performance test suite and provide some benchmarks

description: Create a document in DOCS after running the perf test suite with findings and potential improvements.


title: check coverage again

description: check test coverage again and see if more tests are needed


title: setup github ci

description: Maybe it'd be nice to have github run the tests. Is that a thing we can try to setup


title: UI: Improve accessibility for star icon

description: The new star button should have proper aria-labels and potentially better focus states for screen readers.


title: UI Styling: Dark Mode Support


title: scroll mark as read broken in V3 UI

description: j/k properly select and mark an item as read, but scrolling it off the screen on desktop and mobile don't seem to mark it as read.


title: [feature] light/dark/black toggle

description: Add in a simple [light | dark | black] theme toggler like in the legacy version.


title: Exclude full_content from stream list API responses

description: Benchmarks show ~380KB/op allocation for stream endpoint, largely from serializing full_content field that is not displayed in list views. Excluding this field from list responses would reduce memory allocation and improve API response times. Full content is already available via the /api/item/:id/content scrape endpoint.


title: docker support

description: add support so people can self-host this in docker and (maybe) test it yourself. maybe keep it in a docker directory with separate docs etc.


title: enhance github ci/cq

description: Make sure we have the right CI/CQ things in the github workflow. Can it test our docker compose for us too maybe


title: Vanilla JS (v3): Achieve 80% test coverage


title: Re-enable and fix errcheck lints

description: Re-enable 'errcheck' in .golangci.yml and fix the remaining ~140 issues, mostly related to unchecked Writes and DB operations.

type: cleanup


title: Fix and Re-enable Playwright E2E Tests

description: E2E tests were crashing the VM and timing out. Disabled them in package.json. Need to investigate resource usage and re-enable.


title: v2 ui bug - panel open by default

description: Panel is closed by default, it should be open by default on desktop.


title: serve "legacy" version UI at /v1/ instead of /

description: Let's "softly" start to deprecated the legacy version by moving it to /v1/ -- ideally this won't require any changes but there may be some relative/absolute URLs to adjust in the static files there or in rouoting


title: Mock RSS feeds in E2E tests

description: Currently E2E tests fetch real feeds like CNN, which makes them slow (10s+) and potentially flaky depending on network. Use a local mock server or file-based mocks.


title: Implement Tag View

description: Create frontend view for browsing items by tag/category. Use /tag/:id endpoint.


title: make new v2 UI the default and serve at /

description:
After we move the old UI to be served at v1, serve the new UI at /

We can keep serving it at v2/ as well if we want.


title: Vanilla JS (v3): Redesign to 2-pane glassmorphism (parity with v2)


title: Implement ClientLogin and Token endpoints


title: Implement Stream Contents endpoint


title: get rid of the "selected" highlight thing

description: the legacy version doesn't do that and i find it distracting, j/k just move things up/down


title: Enable Gzip Compression in Go Backend

description: Check if the Go backend is serving content with gzip compression. If not, implement it to reduce page size and improve performance. Add tests to verify.


title: new web frontend

description:
The current frontend uses an old version of backbone and jquery. Let's "deprecate" it -- keep it arouond so we can test against it and use it, but let's be able to also serve and use a nice shiny new frontend written in either simiple, highly efficient vanilla javascript, or put together something in react or similar. Needs to feel fast and low latency!

It's very important that this new frontend has all the functionality of the existing one AND looks similar (use same style, etc, but adjust a little if needed.)

ALSO make it highly testable and have high test coverage as you go. I don't want it to use the Chrome browser plugin thing, just test it on your own using things from the command line you can do.


title: Wire Reader API into web.go


title: make sure the github CI jobs are included in the tests/jobs locally!


title: v2 ui - font size adjustments

description: Move font-size: 18px to :root so rem units resolve correctly. Adjust title size to ~24px.


title: E2E Testing

description: Set up E2E testing with Playwright or Cypress to verify full flows: Login -> View Feeds -> View Items -> Logout


title: UI Styling: Feed Items (Spacing, Dateline)


title: https://computer.rip/rss.xml fails to importa

description: running neko -a https://computer.rip/rss.xml gave an error. debug it and add test case to catch.


title: consistency in sidebar

description: With the new sidebar styling, SETTINGS and LOGOUT and the light/dark look really different than the rest. Let's make them more consistent from a style perspective.


title: update README.md

description:
Ensure the build, configuration, etc are up too date.
Note the git change when we started to vibe-code this in the history (with dates etc.)


title: Fix pre-existing safehttp test failure

description: TestSafeClient in internal/safehttp fails: private IP check returns nil error instead of blocking. The test expects an error for 10.0.0.1 but gets nil.


title: v3 ui: takes 3 presses of 'j' to move to next item

description: Is there some weird timer before it's scrolling it -- after that it's fine. Or a delay to setup the listener or something


title: Vanilla JS: Test Infrastructure & Coverage

description: Setup testing framework (likely vitest or simple runner) for vanilla JS. Refactor code for testability. Aim for 80% coverage on vanilla/app.js logic.


title: test coverage

description:
assume the code works properly (it mostly does)
get to 90% test coverage on the go code


title: add "star" back in

description: rather than the word "star" it should just have a star that changes colors right next to the title


title: Fix backend linting issues reported by golangci-lint

description: golangci-lint reports 64 issues including 46 errcheck violations (ignored errors in web handlers), 13 staticcheck issues (e.g., using 307/401 literals instead of http constants), and minor formatting/unused param issues. These should be addressed to improve code quality.


title: slow scrolling in v2 ui compared to v1

description: When using j/k to go to the next feed, they appeared instantly, now it feels like a slow scroll. Make it speedy again.


title: UI Styling: Sidebar (Fixed, Gray Background)