FREENOTES / WEB RUNTIME v1.0.0

一次接入，
专注业务本身。

为 Web 与 WebView 应用准备的运行时基础库。
统一存储、网络请求与宿主通信，让常用能力触手可及。

开始接入浏览 API

TypeScript 优先框架无关按需使用

runtime.ts从一个 factory 开始

ts

import { createStorage } from '@freenotes/web-runtime';

// 类型跟随 key，读写更安心
interface Preferences {
  theme: 'light' | 'dark';
}

const storage = createStorage<Preferences>('local');

storage.set('theme', 'dark');
const theme = storage.get('theme');
// theme 的类型：'light' | 'dark' | undefined

统一入口独立 factory，按需组合

无 import 副作用实际调用时才访问运行环境

保持框架无关融入现有应用与技术栈

CAPABILITIES

常用能力，各就其位。

从浏览器中的一次读写，
到 WebView 与宿主的每次交互。

Storage

统一 localStorage 与 sessionStorage，管理类型、版本、过期与校验。

createStorage()

HTTP

通过契约声明业务接口，集中管理请求配置、重试、解码与错误语义。

Bridge

连接 WebView 与 App，统一类型化调用、宿主事件和错误处理。

createBridge()

结构化数据

DB

用 Promise 操作 IndexedDB，保留数据库、索引与升级迁移的原生语义。

Logger

标准化日志记录与异常信息，通过 transport 接入自己的上报平台。

createLogger()

Clipboard

复制链接、日志与文本，统一原生 Clipboard API 和 WebView fallback。

createClipboard()

GET STARTED

从你的下一个功能开始。

配置内部 npm 源，安装后按需创建实例。
先用一个能力，再逐步融入你的业务。

阅读完整接入指南

安装 Web Runtime先配置 npm 源 ↗

sh

pnpm add @freenotes/web-runtime

ESM + CommonJS内置 TypeScript 类型

API 约定 创建、错误处理与生命周期 接入示例 将能力组合到真实业务中 设计原则 了解模块边界与设计取舍