Repository navigation
Releases
v0.1.0-rc.6
Added
- Borderless Hand-Drawn Stationery Flow Article Editor: Redesigned
VisualBlockEditorandStudioEditorPanelonto a borderless loose-leaf stationery sheet featuring a/slash command palette (SlashCommandMenu), live Markdown prefix auto-conversion (##,###,####,## [ ],- [ ],-,1.,>,```,:::tip), IME-safeEnter/Backspace/Arrow cross-block split/merge/navigation, in-place<StickerCardFrame>alert editing &<WashiCodeFrame>drafting code pads with floating style/tone/margin-note popovers (BlockFloatingControls), inline selection formatting toolbar, single-axis pointer drag-handle block reordering, and directCtrl+Vclipboard screenshot paste + drag-and-drop image auto-upload across both Visual and Markdown modes.
Changed
- Strict RFC Email Validation, Normalization & Deliverability: Replaced naive
@substring checks across Rust (icehandnote-core,icehandnote-db,icehandnote-api,icehandnote-cli) and React (email.ts,useFormValidation.ts) with unified RFC 5321/5322/1035/5891/2606 validation (validate_and_normalize_email,is_valid_email,is_deliverable_email), canonical lowercase domain normalization, Punycode IDN TLD support, reserved sinkhole filtering (.localhost,.local,.invalid, Null-MX example domains), SMTPfrom_emailvalidation, and post-interaction:user-invalid+ ARIA constraint synchronization across all 7 email forms.
Fixed
- Mobile Studio & Reader Scroll Locking & Swipe Drawer Lifecycle: Scoped
.studio-scroll-pane(overflow-y: auto; overscroll-behavior: contain) strictly to desktop viewports so< 1024pxmobile Studio pages and<RoughDiagram>canvases scroll naturally without touch-scroll trapping, fixedSwipeDrawerDialogIntersectionObserverpremature Frame-1 auto-close & nativeEscapestate sync on#studio-sidebar-drawerand#mobile-chapter-drawer, capped mobileTopNavbarmenu height, and eliminated375pxflex input intrinsic-width overflow in flow editor blocks.
Full Changelog: v0.1.0-rc.5...v0.1.0-rc.6
v0.1.0-rc.5
Added
- W3C WebAuthn Passkeys Authentication & Governance: Added passwordless Passkey sign-in and per-account Passkey management (register, rename, remove,
enable_passkeystoggle) powered by server-sideringverification (ES256, EdDSA, RS256),webauthn-polyfills, Base64URL/rpId validation, and migration0011_multi_oauth_and_passkeys.sql. - Multi-OAuth Unbind & Lockout Guard: Added
DELETE /api/v1/auth/me/oauth/{provider}withCannotUnbindLastAuthenforcement (ensuring users never remove their sole sign-in method when lacking a password or secondary provider) plus OAuth sign-in anomaly OTP challenges. - Structured PostgreSQL Parameter Mode & Ban Notice Emails: Added structured Host/Port/Database/Username/SSL connection editing with masked secret retention (
clear_passwordsupport), and localized 4-localeaccount_bansuspension emails dispatched when admins suspend accounts. - Zero-Flash SSR Bootstrap & URL Tab Persistence: Injected initial
siteSettings, rendered<title>, custom favicon, andcolor-schememetadata server-side intoindex.html, paired with client cache hydration and URL query persistence (?tab=/?section=) across reloads.
Changed
- Reusable Component Architecture & Clean Naming: Decoupled monolithic Auth, Studio Settings, Studio Panel, Navigation, and Notebook views into shared reusable primitives (
ui/,auth/,navigation/,notebook/,studio/blocks/,studio/settings/), split localization dictionaries into per-locale files underapps/web/src/lib/locales/, and removed all version-based identifiers (i18nRc3.ts,0008_rc3_platform_features.sql->0008_collaboration_and_moderation.sql). - Unified Switch Sliders & Pure Segmented Capsule Tabs: Upgraded
<SwitchRow>binary toggles onto a cross-browser accessible CSS pill slider track + sliding thumb (role="switch"+switch) and streamlined.mwg-tabinto pure segmented capsules with forced-colors support.
Fixed
- Refactoring UI Visual Audit & Accessibility Fixes: Resolved
m-0spacing collapse insidespace-y-*containers, strengthened light-mode paper/input contrast (--border-control≥ 3:1 WCAG 1.4.11), enforced WCAG 2.2 AA≥ 24×24pxtouch targets, softened secondary button hierarchy, persisted manual light/dark toggles over site defaults, eliminated 375pxStepProgressNavtruncation and trailing footer separator dots, compacted Studio Editor toolbars onto single rows at1280×800, aligned Command Search cards flush with a themed clear control, removed double borders & disabled self-actions in Studio Users, moved modal scrollbars insideoverflow-hiddenrounded bounds, auto-expanded Split Live Preview textareas viafield-sizing: content, and restored clean single native dropdown arrows on.ink-select.
Full Changelog: v0.1.0-rc.4...v0.1.0-rc.5
v0.1.0-rc.4
Release v0.1.0-rc.4
v0.1.0-rc.3
Note
Pre-release (v0.1.0-rc.3) — Third release candidate of IceHandnote, introducing RFC 9457 standardized API diagnostics with 4-locale Toast localization, dedicated standalone authentication & 3-step gated OTP flows, device/session governance with anomalous login OTP alerts, authentic hand-drawn stationery email templates with customizable footers, a 3-zone WordPress/Canva-style Studio editor, secure image uploads, co-author collaboration, and admin governance.
Added
- RFC 9457 Problem Details & Frontend Toast Localization:
- Standardized all backend error responses to RFC 9457 (
application/problem+jsonwithtype,title,status,detail, machine-readablecode, and optionalmeta), English default messages, RFC 9110 status codes, and RFC 6750WWW-Authenticateheaders. - Added Top-Layer
popover="manual"ToastProviderand 4-locale (zh-CN,en,zh-TW,ja) error resolution so every API error and user confirmation renders cleanly in the active site language.
- Standardized all backend error responses to RFC 9457 (
- Standalone Auth Flows, Gated OTP Verification & Session Governance:
- Dedicated distraction-free flow pages (
/:locale/auth/login,register,forgot-password,reset-password,onboarding, plus/loginand/register) built tomodern-web-guidancestandards. - Single-input 6-slot tactile OTP input (
OtpInput), debounced live username availability check (GET /api/v1/auth/check-username),sessionStorage-persisted + server-enforced 60s resend cooldowns (429+Retry-After), and strict 3-step gated password reset (Email → OTP Verification via POST /api/v1/auth/verify-reset-otp → New Password + Confirm Password). - Advisory-only visual
<progress>password strength meter (PasswordStrengthMeter) across Register, Reset Password, Personal Center Change Password, and Admin Create/Reset User dialogs. - Per-session IP, User-Agent device parsing, device fingerprinting (
X-Device-Id), self-service Devices & Sessions revocation in Personal Center, and anomalous login (new_ip/new_device) email OTP challenges. - Full OAuth 2.0 / OIDC sign-in, first-time onboarding, existing-account OAuth binding, and Gravatar/OAuth/uploaded avatar sources.
- Dedicated distraction-free flow pages (
- Hand-Drawn Loose-Leaf Stationery HTML Emails & Customizable Footer:
- Redesigned all 6 HTML email templates (
register_code,login_anomaly,reset,invite,takedown,test) across all 4 site locales (zh-CN,en,zh-TW,ja) with automatic site-locale matching, live site logo embedding, zero top horizontal color bar, dot-grid paper desk canvas, sepia-ink stacked paper card, tilted dashed rubber stamp pill, pastel highlighter heading stroke, perforated OTP ticket, and WCAG AA/AAA verified contrast. - Added customizable email footer (
email_footer_text, supporting{{site_name}}) with sandboxed Desktop/Mobile 4-locale live preview in Studio Settings.
- Redesigned all 6 HTML email templates (
- 3-Zone Studio Article Editor, Image Blocks & Collaboration / Admin Governance:
- Separated Studio article editing into top Workbench Action & Contextual Tool Bar, center Writing & Design Canvas (Visual Block Editor + Markdown Source Editor + optional Live Preview), and collapsible right Article Inspector (
StudioEditorInspector). - Native Markdown
imageblocks with magic-byte validated uploads (/api/v1/uploads,/api/v1/studio/uploads) and hardened/uploads/{ym}/{filename}delivery (SHA-256 ETag,304,nosniff, CSP sandbox). - Multi-author attribution, email co-author invitations, admin article takedown/restore, track/chapter deletion, admin user lifecycle management, and live local ↔ PostgreSQL storage hot-switching.
- Replaced legacy sample tracks with a clean 4-locale
content/getting-started/welcome track.
- Separated Studio article editing into top Workbench Action & Contextual Tool Bar, center Writing & Design Canvas (Visual Block Editor + Markdown Source Editor + optional Live Preview), and collapsible right Article Inspector (
CI & Container Release
- Restricted
ghcr.io/cloudwhile/icehandnote:lateststrictly to publishedv*release tags (branch builds push by digest and tag only:sha256-<digest>), added automatic legacy:latestself-healing, and guarded Shields.io GHCR Deployment tracking against branch/tag race conditions.
Quick Deploy (Docker)
docker run -d \
--name icehandnote \
--restart unless-stopped \
-p 3001:3001 \
-v $(pwd)/data:/app/data \
-v $(pwd)/content:/app/content \
-e ADMIN_USERNAME=admin \
-e ADMIN_PASSWORD=ChangeMe_StrongPassword \
-e DEFAULT_LOCALE=zh-CN \
ghcr.io/cloudwhile/icehandnote:v0.1.0-rc.3Full Changelog: v0.1.0-rc.2...v0.1.0-rc.3
v0.1.0-rc.2
Note
Pre-release (v0.1.0-rc.2) — Second release candidate of IceHandnote, adding one-command Docker persistence & admin bootstrap, fixing Simplified Chinese typography, HTTP clipboard copying, and full-width code cards.
Added
- Docker Persistence & Entrypoint (
DATA_DIR&CONTENT_DIR):- Standardized
/app/data(store.json) and/app/contentvolumes withdocker-entrypoint.sh(gosuprivilege drop, automatic host bind-mount ownership handling, and automatic starter notebook seeding when/app/contentis empty).
- Standardized
- Startup Admin Account Bootstrap:
- Configure
ADMIN_USERNAME,ADMIN_PASSWORD,ADMIN_EMAIL, andADMIN_DISPLAY_NAMEonicehandnote-apistartup for both built-in local storage and PostgreSQL. - When
ADMIN_PASSWORDis omitted on first boot (zero existing admins), an initial password is automatically generated, persisted, and printed indocker logs. icehandnote-cli create-adminnow also supports standalone local storage (DATA_DIR).
- Configure
Fixed
- Simplified & Traditional Chinese Typography: Isolated CJK font stacks per locale, loaded
LXGW WenKai Screen(GB standard strokes), removed Japanese-onlyKlee Oneand unhintedKaiTifallbacks from Chinese pages, and scopedfont-size-adjust: from-fontto English pages. - Clipboard Copy over Plain HTTP: Added synchronous selection copy fallback when
navigator.clipboardis unavailable on non-HTTPS origins (http://<ip>:<port>), plus an accessiblerole="status"live region. - Full-Width Reader Code Cards & Blocks: Removed inner
65chcaps and unconditional220pxright-margin column reservation on blocks without margin sticky notes. - Instant GHCR Version Badge: Recorded published GHCR versions via GitHub Deployments API (
cacheSeconds=60) with automatic GitHub Camo cache purge in CI.
Quick Deploy (Docker)
docker run -d \
--name icehandnote \
--restart unless-stopped \
-p 3001:3001 \
-v $(pwd)/data:/app/data \
-v $(pwd)/content:/app/content \
-e ADMIN_USERNAME=admin \
-e ADMIN_PASSWORD=ChangeMe_StrongPassword \
-e DEFAULT_LOCALE=zh-CN \
ghcr.io/cloudwhile/icehandnote:v0.1.0-rc.2Full Changelog: v0.1.0-rc.1...v0.1.0-rc.2
v0.1.0-rc.1
Note
Pre-release (v0.1.0-rc.1) — First release candidate of IceHandnote, licensed under AGPL-3.0.
Added
Hand-Drawn Notebook & Stationery Reader
- Drafting Code Cards: 4 stationery sheet styles (
washigrid,spiralruled,indexpaperclip card,torndraft slip) with dual-theme WCAG AA syntax tokens. - 3-Axis Decoupled Stickers: 9 semantic alert types × 7 physical silhouettes × 6 dual-theme paper palettes + custom postmark badges.
- Interactive Margin Notes: Author annotations and reader sticky notes attachable to both prose paragraphs and code cards.
- Per-Article Licensing: Author-selectable Creative Commons (
CC 4.0variants,CC0 1.0) andAll Rights Reservedpostmark stamp cards with localized official CC deed links.
Checkable Tasks
- Section Tasks (
## [ ] Heading): Checkable section milestones synchronized between section headings and footers. - Paragraph Tasks (
- [ ] Title | Detail): Inline checkable tasks between paragraphs with persistent learner progress tracking.
Multilingual Studio Workspace (/:locale/studio)
- Lossless Dual-Mode Editor: Bidirectional visual block editor and raw Markdown source editor with configurable draft auto-save.
- Translation Catalog Matrix: 4-locale (
en,zh-CN,zh-TW,ja) publishing workflow with canonical revision drift detection. - White-Label & Update Check: Live site identity, theme, locale, feature configuration, and upstream release / GHCR update checker.
Storage, Deployment & Authentication
- Zero-Dependency Default Storage: Built-in local file repository (
LocalSeedRepository) out of the box, plus optional external PostgreSQL 17 (PGroonga) full-text search backend. - Authentication: Argon2id local user accounts, CLI admin bootstrap (
icehandnote-cli), and optional WordPress HMAC-SHA256 cross-site SSO bridge (deploy/wordpress-sso-bridge.php).
Container Images & Standalone Bundles
Docker / GHCR
docker run -d --name icehandnote -p 3001:3001 ghcr.io/cloudwhile/icehandnote:v0.1.0-rc.1Standalone Bundles
| Platform | Target | Archive | Checksum |
|---|---|---|---|
| Windows (x64) | x86_64-pc-windows-msvc |
icehandnote-windows-x86_64.zip |
icehandnote-windows-x86_64.zip.sha256 |
| Linux (x64) | x86_64-unknown-linux-gnu |
icehandnote-linux-x86_64.tar.gz |
icehandnote-linux-x86_64.tar.gz.sha256 |
Verify archive integrity with SHA-256 before extraction:
# Linux
sha256sum -c icehandnote-linux-x86_64.tar.gz.sha256
# Windows PowerShell
(Get-FileHash .\icehandnote-windows-x86_64.zip -Algorithm SHA256).Hash.ToLower()Full Commit History: v0.1.0-rc.1