Why it is worth attention

It reimagines a blog as a self-contained, portable file that requires no backend, yet still offers rich features like encryption, themes, and backup-before-update.

Who it is for

Privacy-conscious individuals who want full control over their data
Tech enthusiasts interested in single-file applications
Writers or journalers needing an offline, portable diary
Users looking for a simple, no‑server blogging alternative

Use cases

Keeping a private, encrypted diary on a USB drive
Writing notes or a journal without relying on cloud services
Creating a personal blog that can be carried across computers
Testing or learning about File System Access API and client‑side encryption

Strengths

Works entirely offline with no server, database, or accounts
Supports AES‑GCM‑256 encryption via Web Crypto API
Guarantees a verified backup before every internal update
Offers multiple skins, tags, and a visual editor with auto‑save

Considerations

Full direct saving works only in Chromium browsers (Chrome, Edge) with File System Access API
Password loss means permanent data loss—no recovery possible
Single file may become large with many images and notes; no built‑in content export besides the file itself

README quick start

Флог (от «файловый лог»)

Персональный блог, который живёт в одном HTML-файле

Флог выглядит как сайт и работает в браузере, но лежит не в интернете, а у вас на компьютере или флешке. Сервер, база данных и аккаунт не нужны: браузер с разрешения пользователя записывает заметки прямо в файл.

Внутри одного index.html находятся интерфейс, настройки, тексты и изображения. Файл можно перенести на другой компьютер и продолжить писать.

Возможности

визуальный редактор с заголовками, списками, цитатами, ссылками, кодом, изображениями и подписями;
автоматическое сохранение черновиков;
поиск, теги, цвета заметок и статистика текста;
пять скинов: «Нормкор», «Сердечки», «Манга», «Строгий» и «Консоль»;
цветные фоны, светлая и тёмная темы;
шифрование заметок, черновиков и изображений паролем;
обновление внутренней программы перетаскиванием нового файла;
обязательная проверенная резервная копия перед обновлением.

Как начать

Скачайте index.html.
Откройте его в браузере как обычный файл.
Нажмите + и создайте первую заметку.
При первой записи выберите этот же index.html в системном окне.

Прямая запись в файл работает в настольных Chrome, Edge и других Chromium-браузерах с поддержкой File System Access API. В остальных браузерах Флог предложит скачать обновлённую копию.

Шифрование

Флог использует браузерный Web Crypto API: содержимое шифруется алгоритмом AES-GCM-256, а ключ выводится из пароля через PBKDF2-HMAC-SHA-256. Пароль нигде не сохраняется и не отправляется в сеть.

Если забыть пароль, восстановить заметки невозможно. Перед включением шифрования стоит убедиться, что пароль сохранён в надёжном месте.

Обновление

Обычная замена файла здесь не подходит: файл Флога одновременно является и программой, и вашим дневником.

Чтобы обновиться:

скачайте новый index.html из этого репозитория;
откройте свой текущий Флог;
перетащите новый файл в окно браузера;
подтвердите обновление.

Флог сначала предложит сохранить резервную копию через системное окно и проверит записанный файл. Только после этого отдельным нажатием можно установить обновление. Заметки, изображения, черновики и настройки будут перенесены в новую версию. Используйте для обновления только файл, которому доверяете.

Разработка

Читаемые исходники и инструменты сборки находятся в скрытой папке .src. Готовое приложение

Description

Флог — персональный блог, умещающийся в файле

Related repositories

Similar projects matched by category, topics, and programming language.

ddosi

Featured

PacketLens

PacketLens is a pure front-end, offline pcap analysis tool that runs entirely in the browser, supporting deep protocol decoding, HTTPS decryption, and million-packet instant loading without any backend.

HTML

ViffyGwaanl

Featured

kimi-k3-learn

An interactive learning system that turns the 47-page Kimi K3 technical report into a single offline HTML file with running algorithms, 3D visualizations, spaced repetition quizzes, and a smart highlighting QA tool.

AI & Machine Learning

iamtechartist

Featured

human-cell-visualizer

An interactive 3D visualization of three human cell types using Three.js, WebGL particles, and custom GLSL shaders, allowing users to rotate, zoom, morph, and explore annotated structures.

Design & Creative