1. Project Overview & Quickstart (zhanglun/lettura) Copy Chapter

Lettura

Follow your favorite content and never miss a story.

Another free and open-source feed reader designed to deliver an exceptional reading experience across multiple platforms.

Features Copy Section

• Cross-Platform Compatibility: Seamlessly access your feeds on macOS, Windows, and soon Linux, ensuring your reading experience is uninterrupted regardless of your operating system.
• Lightning-Fast Performance: Built with speed in mind, Lettura ensures that you can browse and read your favorite content without any lag or delay.
• Beautiful and Intuitive UI: Thanks to the elegant design from @shadcn/ui, Lettura offers a clean, distraction-free interface that makes reading a pleasure.
• Powerful Search Functionality: Quickly find the content you need with our efficient search feature that works across all your subscribed feeds.
• Keyboard Shortcuts: Master your reading experience with easy-to-use keyboard shortcuts that let you navigate and interact with nearly every function without lifting a finger.
• Podcast playback support: Enjoy your favorite audio content directly within the app without missing a single episode.

Get Started Copy Chapter

Prerequisites Copy Section

• Install Node.js. I recommend you to use NVM.
• Install pnpm. Here is the manual.
• Install Rust. You can find way in here
• Follow the Tauri setup guide
• Run pnpm install

Develop and Build Copy Section

Desktop app (Tauri):

pnpm dev:desktop    # Frontend dev only
pnpm tauri dev      # Full desktop dev mode
pnpm tauri build    # Build desktop app
pnpm test           # Run tests

Docs site:

pnpm dev:docs       # Dev server for docs
pnpm build:docs     # Build docs site

You can get more details about building Tauri app in here

Repo Activity Copy Chapter

More Projects Copy Section

• Pavo: mini desktop wallpaper application.
• BookWise: book wise, read wiser

2. Official Technical Reference & Guides (zhanglun/zhanglun.github.io) Copy Chapter

zhanglun.github.io

张小伦的网络日志。项目基于 Astro 构建，主要用于发布博客、项目页和个人介绍内容。

技术栈 Copy Chapter

• Astro
• React
• TypeScript
• Tailwind CSS
• Fuse.js
• Mermaid
• Notion API 内容同步

本地开发 Copy Chapter

项目使用 pnpm 管理依赖。

pnpm install
pnpm dev

开发服务默认运行在 http://localhost:3000。

常用命令 Copy Chapter

项目结构 Copy Chapter

.
├── public/              # 静态资源、字体、站点图片
├── scripts/             # Notion 内容同步脚本
├── src/
│   ├── assets/          # 资源引用
│   ├── components/      # Astro 和 React 组件
│   ├── content/         # Markdown 内容
│   │   ├── about/       # 个人介绍内容
│   │   ├── blogs/       # 本地博客文章
│   │   ├── labs/        # 实验内容
│   │   └── notion/      # Notion 同步文章
│   ├── data/            # 静态数据
│   ├── layouts/         # 页面布局
│   ├── pages/           # Astro 路由页面
│   ├── styles/          # 全局样式
│   ├── utils/           # 工具函数
│   ├── config.ts        # 站点配置
│   └── content.config.ts # Astro 内容集合配置
├── astro.config.mjs
├── tailwind.config.cjs
├── tsconfig.json
└── package.json

内容管理 Copy Chapter

博客内容由 Astro Content Collections 管理，集合定义在
src/content.config.ts。

• blogs: 读取 src/content/blogs/**/*.md
• notion: 读取 src/content/notion/**/index.md

文章 frontmatter 常用字段：

title: 文章标题
date: 2026-01-01
tags:
  - frontend
categories:
  - notes
draft: false

生产构建会过滤 draft: true 的文章。

Notion 同步 Copy Chapter

运行以下命令从 Notion 拉取内容：

pnpm download

同步脚本位于 scripts/notion/，生成的文章会进入
src/content/notion/。

环境变量 Copy Chapter

可在项目根目录创建 .env：

PUBLIC_GOOGLE_SITE_VERIFICATION=your-verification-code

PUBLIC_ 前缀的变量会暴露给客户端代码。

构建与部署 Copy Chapter

pnpm build

构建产物输出到 dist/。部署前可以运行：

pnpm preview

许可 Copy Chapter

package.json 声明为 0BSD。