Hygiene improvements: CI, deployment, code quality

.github/workflows/ci.yml

@@ -0,0 +1,93 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    name: Lint & Validate
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint JavaScript
+        run: npm run lint
+
+      - name: Check formatting
+        run: npm run format
+
+      - name: Validate HTML
+        run: npm run validate:html
+
+      - name: Validate CSS
+        run: npm run validate:css
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    needs: validate
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build (inject SW version)
+        run: npm run build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs
+
+  deploy:
+    name: Deploy
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.htmlvalidate.json

@@ -0,0 +1,9 @@
+{
+  "extends": ["html-validate:recommended"],
+  "rules": {
+    "no-inline-style": "off",
+    "require-sri": "off",
+    "doctype-style": "off",
+    "void-style": "off"
+  }
+}

.nvmrc

@@ -0,0 +1 @@
+22

.prettierignore

@@ -0,0 +1,9 @@
+node_modules/
+todos/
+scripts/
+workers/
+docs/assets/fonts/
+docs/assets/images/
+*.woff2
+*.png
+*.svg

.prettierrc

@@ -0,0 +1,8 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "printWidth": 100,
+  "trailingComma": "es5",
+  "htmlWhitespaceSensitivity": "ignore"
+}

.stylelintrc.json

@@ -0,0 +1,11 @@
+{
+  "extends": ["stylelint-config-standard"],
+  "rules": {
+    "selector-class-pattern": null,
+    "custom-property-pattern": null,
+    "declaration-block-no-redundant-longhand-properties": null,
+    "no-descending-specificity": null,
+    "font-family-name-quotes": null,
+    "keyframes-name-pattern": null
+  }
+}

CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+All notable changes to 1mb.dev will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [Unreleased]
+
+### Added
+
+- MIT LICENSE file
+- `.nvmrc` for Node.js version consistency
+- CHANGELOG.md for release tracking
+- CI pipeline with ESLint, Prettier, HTML/CSS validation
+- humans.txt with project philosophy
+- Counter API `/health` endpoint with Redis connectivity check
+- Wrangler CLI setup for Counter API deployment
+
+### Changed
+
+- Refactored 404.html to use shared stylesheet (171 → 35 lines)
+- Improved semantic markup: `<hr>` for separator, `<section>` for counter
+- Added `meta author` tag and `type="button"` attributes
+- Updated manifest description for consistency
+- Added `site.webmanifest` to Service Worker cache
+- Bumped Service Worker cache to v4
+
+## [1.1.0] - 2025-01
+
+### Added
+
+- Context section: "Sometimes solo. Sometimes inside a team. Always accountable."
+- Invitation line bridging manifesto and counter
+- Community counter with anonymous voting
+- Dark/light theme toggle with system preference detection
+- Parallax effect on watermark (respects reduced motion)
+- Service Worker for offline support
+- PWA manifest for mobile installation
+
+### Changed
+
+- Refined copy to ownership mindset
+- Updated og-image with current style and copy
+- UI refresh: typography, spacing, visual depth
+- Reorganized assets into proper folder structure
+
+## [1.0.0] - 2024-12
+
+### Added
+
+- Initial landing page
+- Brand assets and SEO markup
+- GitHub Pages deployment with custom domain (1mb.dev)
+- robots.txt and sitemap.xml
+- Self-hosted fonts (Inter, Space Grotesk)

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 1mb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -13,3 +13,27 @@ A quiet corner for those who build.
 Some build with teams and titles. Others just build.
 
 This is for the others.
+
+---
+
+## Development
+
+```bash
+npm install
+npm run validate      # lint, format, html/css checks
+npm run build         # inject SW version (git SHA)
+```
+
+### Counter API
+
+```bash
+npm run worker:dev      # local development
+npm run worker:deploy   # deploy to Cloudflare
+npm run worker:tail     # view live logs
+```
+
+See [workers/README.md](workers/README.md) for setup details.
+
+## License
+
+[MIT](LICENSE)