Compare commits
10 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 3145acc423 | |||
| ce3fc36835 | |||
| c267bc86a8 | |||
| c790a7236c | |||
| 0ef2184204 | |||
| ca3564a1ec | |||
| e6ca9a078d | |||
| 67973b27aa | |||
| faf5fc1797 | |||
| af8e705919 |
@@ -0,0 +1,44 @@
|
|||||||
|
root = "."
|
||||||
|
testdata_dir = "testdata"
|
||||||
|
tmp_dir = "tmp"
|
||||||
|
|
||||||
|
[build]
|
||||||
|
args_bin = []
|
||||||
|
bin = "./tmp/main"
|
||||||
|
cmd = "go build -o ./tmp/main ./cmd/server"
|
||||||
|
delay = 500
|
||||||
|
exclude_dir = ["assets", "tmp", "vendor", "testdata", ".git", "node_modules"]
|
||||||
|
exclude_file = []
|
||||||
|
exclude_regex = ["_test\\.go$"]
|
||||||
|
exclude_unchanged = false
|
||||||
|
follow_symlink = false
|
||||||
|
full_bin = ""
|
||||||
|
include_dir = []
|
||||||
|
include_ext = ["go", "html", "css", "js"]
|
||||||
|
include_file = []
|
||||||
|
kill_delay = "0s"
|
||||||
|
log = "build-errors.log"
|
||||||
|
poll = false
|
||||||
|
poll_interval = 0
|
||||||
|
rerun = false
|
||||||
|
rerun_delay = 500
|
||||||
|
send_interrupt = false
|
||||||
|
stop_on_error = false
|
||||||
|
|
||||||
|
[color]
|
||||||
|
app = ""
|
||||||
|
build = "yellow"
|
||||||
|
main = "magenta"
|
||||||
|
runner = "green"
|
||||||
|
watcher = "cyan"
|
||||||
|
|
||||||
|
[log]
|
||||||
|
main_only = false
|
||||||
|
time = false
|
||||||
|
|
||||||
|
[misc]
|
||||||
|
clean_on_exit = true
|
||||||
|
|
||||||
|
[screen]
|
||||||
|
clear_on_rebuild = false
|
||||||
|
keep_scroll = true
|
||||||
@@ -15,6 +15,9 @@ jobs:
|
|||||||
with:
|
with:
|
||||||
go-version: '1.22'
|
go-version: '1.22'
|
||||||
|
|
||||||
|
- name: Vet
|
||||||
|
run: go vet ./...
|
||||||
|
|
||||||
- name: Run tests
|
- name: Run tests
|
||||||
run: go test -race ./...
|
run: go test -race ./...
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,116 @@
|
|||||||
|
# Gitea Mobile
|
||||||
|
|
||||||
|
A mobile-first Progressive Web App (PWA) for managing Gitea issues and pull requests across multiple repositories and organizations from an iPhone. Built with Go, HTMX, and hand-rolled CSS -- no JavaScript frameworks, no build step, no node_modules.
|
||||||
|
|
||||||
|
## Tech Stack
|
||||||
|
|
||||||
|
| Layer | Choice |
|
||||||
|
|-------|--------|
|
||||||
|
| Backend | Go + Gitea SDK (`code.gitea.io/sdk/gitea`) |
|
||||||
|
| Frontend | HTMX + Go `html/template` + hand-rolled CSS |
|
||||||
|
| Container | Multi-stage Dockerfile -> distroless (~15MB) |
|
||||||
|
| Deployment | Kustomize manifests + FluxCD GitOps |
|
||||||
|
|
||||||
|
## Project Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
/
|
||||||
|
├── cmd/server/main.go # entrypoint
|
||||||
|
├── internal/
|
||||||
|
│ ├── config/config.go # env-based configuration
|
||||||
|
│ ├── gitea/client.go # Gitea SDK wrapper / aggregation layer
|
||||||
|
│ ├── handlers/ # HTTP handlers (issues, PRs, triage, settings)
|
||||||
|
│ ├── auth/ # cookie-based token auth
|
||||||
|
│ ├── middleware/ # auth middleware, logging
|
||||||
|
│ └── templates/ # Go html/template files (for HTMX)
|
||||||
|
├── static/ # CSS, JS (htmx.min.js), icons, manifest
|
||||||
|
├── .gitea/workflows/build.yaml # CI pipeline (Gitea Actions)
|
||||||
|
├── Dockerfile
|
||||||
|
├── flake.nix # Nix dev shell with Go + air
|
||||||
|
└── go.mod
|
||||||
|
```
|
||||||
|
|
||||||
|
## Local Development
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
|
||||||
|
- [Nix](https://nixos.org/download/) with flakes enabled, **or** Go 1.22+
|
||||||
|
- A Gitea instance with an API token
|
||||||
|
|
||||||
|
### Quick Start
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Enter the Nix dev shell (provides Go, gopls, air)
|
||||||
|
nix develop
|
||||||
|
|
||||||
|
# Set required environment variables
|
||||||
|
export GITEA_URL=https://gitea.leeworks.dev
|
||||||
|
export SESSION_SECRET=$(openssl rand -hex 32)
|
||||||
|
|
||||||
|
# Optional: set a default API token
|
||||||
|
export GITEA_TOKEN=your-gitea-api-token
|
||||||
|
|
||||||
|
# Start the server with live reload
|
||||||
|
air
|
||||||
|
```
|
||||||
|
|
||||||
|
If you are not using Nix, install Go 1.22+ and [air](https://github.com/air-verse/air) manually, then run the same commands above starting from the export lines.
|
||||||
|
|
||||||
|
### Environment Variables
|
||||||
|
|
||||||
|
| Variable | Required | Default | Description |
|
||||||
|
|----------|----------|---------|-------------|
|
||||||
|
| `GITEA_URL` | Yes | -- | Base URL of the Gitea instance |
|
||||||
|
| `SESSION_SECRET` | Yes | -- | HMAC key for signing session cookies (min 32 chars) |
|
||||||
|
| `GITEA_TOKEN` | No | -- | Default API token (users can set their own via the settings page) |
|
||||||
|
| `LISTEN_ADDR` | No | `:8080` | Server listen address |
|
||||||
|
|
||||||
|
### Live Reload with Air
|
||||||
|
|
||||||
|
The dev shell includes [air](https://github.com/air-verse/air) for automatic recompilation on file changes. Configuration is in `.air.toml`. Air watches `.go` and `.html` files under `cmd/`, `internal/`, and `static/` and rebuilds/restarts the server automatically.
|
||||||
|
|
||||||
|
## Running Tests
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Run all tests
|
||||||
|
go test ./...
|
||||||
|
|
||||||
|
# Run tests with race detection
|
||||||
|
go test -race ./...
|
||||||
|
```
|
||||||
|
|
||||||
|
## Building the Container
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Build the Docker image
|
||||||
|
docker build -t gitea-mobile .
|
||||||
|
|
||||||
|
# Run locally
|
||||||
|
docker run -p 8080:8080 \
|
||||||
|
-e GITEA_URL=https://gitea.leeworks.dev \
|
||||||
|
-e SESSION_SECRET=$(openssl rand -hex 32) \
|
||||||
|
gitea-mobile
|
||||||
|
```
|
||||||
|
|
||||||
|
The Dockerfile uses a multi-stage build: Go binary compiled in an Alpine builder stage, then copied into a distroless image (~15MB final size).
|
||||||
|
|
||||||
|
## Deployment
|
||||||
|
|
||||||
|
Kubernetes manifests for this app live in the Talos cluster repo under `testing1/first-cluster/apps/gitea-mobile/`. FluxCD syncs from that repo and handles automated image updates via `ImagePolicy` annotations.
|
||||||
|
|
||||||
|
Key deployment resources:
|
||||||
|
- `deployment.yaml` -- Pod spec with health checks
|
||||||
|
- `service.yaml` -- ClusterIP service on port 8080
|
||||||
|
- `ingressroute.yaml` -- Traefik IngressRoute for `gitea-mobile.testing.leeworks.dev`
|
||||||
|
- `kustomization.yaml` -- Kustomize overlay
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
1. Fork the repository
|
||||||
|
2. Create a feature branch: `git checkout -b feature/your-feature`
|
||||||
|
3. Make your changes and add tests
|
||||||
|
4. Run `go test -race ./...` to verify
|
||||||
|
5. Commit with a clear message referencing the issue number
|
||||||
|
6. Push to your fork and open a pull request
|
||||||
|
|
||||||
|
All PRs target the fork (`leeworks-agents/gitea-mobile`), not the upstream repo.
|
||||||
+3
-3
@@ -73,9 +73,9 @@ curl -s https://gitea-mobile.testing.leeworks.dev | head -5
|
|||||||
3. Tap on a PR to see details
|
3. Tap on a PR to see details
|
||||||
4. **Expected**: PR diff summary or review status displays correctly
|
4. **Expected**: PR diff summary or review status displays correctly
|
||||||
|
|
||||||
## Step 7: Core Functionality -- Triage Queue
|
## Step 7: Core Functionality -- Dashboard / Triage Queue
|
||||||
|
|
||||||
1. Navigate to the Triage tab (`/triage`)
|
1. Navigate to the Dashboard/Triage tab (`/`)
|
||||||
2. **Expected**: Unassigned issues and PRs awaiting review appear sorted by priority
|
2. **Expected**: Unassigned issues and PRs awaiting review appear sorted by priority
|
||||||
|
|
||||||
## Step 8: Create Issue (Write Operation)
|
## Step 8: Create Issue (Write Operation)
|
||||||
@@ -116,7 +116,7 @@ curl -s https://gitea-mobile.testing.leeworks.dev | head -5
|
|||||||
| 4 | Auth | Token saved, API calls work |
|
| 4 | Auth | Token saved, API calls work |
|
||||||
| 5 | Issues | List loads, filter works |
|
| 5 | Issues | List loads, filter works |
|
||||||
| 6 | PRs | List loads with review status |
|
| 6 | PRs | List loads with review status |
|
||||||
| 7 | Triage | Queue displays correctly |
|
| 7 | Dashboard/Triage | Queue displays correctly at `/` |
|
||||||
| 8 | Create issue | Issue created in Gitea |
|
| 8 | Create issue | Issue created in Gitea |
|
||||||
| 9 | Apply label | Label applied via API |
|
| 9 | Apply label | Label applied via API |
|
||||||
| 10 | PWA | Standalone mode, safe areas, dark mode |
|
| 10 | PWA | Standalone mode, safe areas, dark mode |
|
||||||
|
|||||||
+53
-2
@@ -1,4 +1,12 @@
|
|||||||
/* Gitea Mobile — Mobile-first CSS (~5KB target) */
|
/* Gitea Mobile — Mobile-first CSS
|
||||||
|
* Dark-mode-first: dark colors are the :root defaults.
|
||||||
|
* Light mode is applied via @media (prefers-color-scheme: light).
|
||||||
|
*
|
||||||
|
* Size note: The original ~5KB target was based on the initial Phase 1 scope.
|
||||||
|
* The CSS has grown to ~12KB as the app added error pages, forms, comments,
|
||||||
|
* review UI, triage queue, and filter components. All rules are in active use.
|
||||||
|
* Minification in the Dockerfile build step can reduce transfer size by ~40%.
|
||||||
|
*/
|
||||||
|
|
||||||
/* Reset */
|
/* Reset */
|
||||||
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
|
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
|
||||||
@@ -533,7 +541,7 @@ a:active {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/* Dark mode is default; light mode override if needed */
|
/* Dark mode is default; light mode override for prefers-color-scheme: light */
|
||||||
@media (prefers-color-scheme: light) {
|
@media (prefers-color-scheme: light) {
|
||||||
:root {
|
:root {
|
||||||
--bg-primary: #ffffff;
|
--bg-primary: #ffffff;
|
||||||
@@ -543,6 +551,49 @@ a:active {
|
|||||||
--text-primary: #1f2328;
|
--text-primary: #1f2328;
|
||||||
--text-secondary: #656d76;
|
--text-secondary: #656d76;
|
||||||
--text-link: #0969da;
|
--text-link: #0969da;
|
||||||
|
--accent-green: #1a7f37;
|
||||||
|
--accent-red: #cf222e;
|
||||||
|
--accent-yellow: #9a6700;
|
||||||
|
--accent-blue: #0969da;
|
||||||
|
--accent-purple: #8250df;
|
||||||
|
}
|
||||||
|
|
||||||
|
.message.success {
|
||||||
|
background: #dafbe1;
|
||||||
|
border-color: #1a7f37;
|
||||||
|
}
|
||||||
|
|
||||||
|
.message.error {
|
||||||
|
background: #ffebe9;
|
||||||
|
border-color: #cf222e;
|
||||||
|
}
|
||||||
|
|
||||||
|
.message.info {
|
||||||
|
background: #ddf4ff;
|
||||||
|
border-color: #0969da;
|
||||||
|
}
|
||||||
|
|
||||||
|
.btn-primary {
|
||||||
|
background: #1a7f37;
|
||||||
|
}
|
||||||
|
|
||||||
|
.btn-primary:active {
|
||||||
|
background: #116329;
|
||||||
|
}
|
||||||
|
|
||||||
|
.btn-danger {
|
||||||
|
background: #ffebe9;
|
||||||
|
border-color: #cf222e;
|
||||||
|
}
|
||||||
|
|
||||||
|
.type-issue {
|
||||||
|
background: rgba(9, 105, 218, 0.1);
|
||||||
|
border-color: rgba(9, 105, 218, 0.3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.type-pull {
|
||||||
|
background: rgba(26, 127, 55, 0.1);
|
||||||
|
border-color: rgba(26, 127, 55, 0.3);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user