.
diff --git a/README.md b/README.md
index 0db47bc..ee14c49 100644
--- a/README.md
+++ b/README.md
@@ -1,35 +1,133 @@
+
+
# Daymark
-A self-hosted, multi-user diary for days, places, people, and ideas.
+**Your days, in your own words.**
-Daymark combines Markdown journaling, photos and media, maps, calendar and timeline views, search, sharing, account exports, and administration. It includes password authentication, TOTP, passkeys, and an installable web app.
+A self-hosted diary for memories, places, people, and ideas.
-## Run with Docker
+[](LICENSE)
+[](#quick-start)
-1. Copy `.env.example` to `.env`.
-2. Set three different strong random secrets in `.env`.
-3. Run `docker compose up -d --build`.
-4. Open `http://localhost:3000` and create your first account.
+[Get started](#quick-start) · [Screenshots](#screenshots) · [Deployment guide](DEPLOYMENT.md) · [Changelog](CHANGELOG.md)
-The first account becomes administrator. The included Mailpit development inbox is available on port 8025. Configure production email and HTTPS before making an installation available online; set `COOKIE_SECURE` to `true` behind HTTPS.
+
-PostgreSQL, media storage, mail, and backups use Compose-project-scoped volumes. Use a distinct project name for every installation. Never point a test or public instance at another installation's database or volumes.
+
-`docker-compose.standalone.yml` is an equivalent portable configuration. See [deployment instructions](DEPLOYMENT.md).
+Daymark gives you a place to write, collect photos and recordings, and revisit the moments that matter. Run it on your own server, keep entries private, or share selected memories with others.
+
+## What you can do
+
+| | Features |
+| --- | --- |
+| **Write** | Markdown, drafts, writing prompts, templates, and entry revision history. |
+| **Collect** | Photos, video, audio, documents, voice notes, and links alongside your writing. |
+| **Rediscover** | Search, tags, journals, calendar, timeline, gallery, maps, and statistics. |
+| **Share** | Multiple accounts, shared journals, comments, and expiring sharing links. |
+| **Protect** | Private entries, optional text encryption, two-factor authentication, and passkeys. |
+| **Take it with you** | An installable web app, offline drafts, exports, and backups. |
+
+## Screenshots
+
+Screenshots show the real interface with fictional sample entries.
+
+### A timeline of your days
+
+Browse your journal chronologically and jump back into a memory.
+
+
+
+### Space to write
+
+Format your entry, choose its date, and add tags, media, or a location.
+
+
+
+## Quick start
+
+**You need:** Docker Engine with Docker Compose, or Docker Desktop.
+
+### 1. Get Daymark
+
+```sh
+git clone https://github.com/donishki/Daymark.git
+cd Daymark
+```
+
+You can also clone from [Gitea](https://git.ptbox.org/dasp/Daymark).
+
+### 2. Set your secrets
+
+Copy `.env.example` to `.env`:
+
+```sh
+cp .env.example .env
+```
+
+On Windows PowerShell, use `Copy-Item .env.example .env`.
+
+Open `.env` in a text editor and fill in all three values with **different, strong random secrets**:
+
+```dotenv
+DB_PASSWORD=
+MINIO_PASSWORD=
+AUTH_ENCRYPTION_KEY=
+```
+
+Keep this file safe. You will need the same values when restoring your installation.
+
+### 3. Start the app
+
+```sh
+docker compose up -d --build
+```
+
+Open **[localhost:3000](http://localhost:3000)** and create your account. The first account becomes the administrator.
+
+Installing on another machine? Replace `localhost` with that server's address.
+
+> **Before going online:** configure HTTPS, set `COOKIE_SECURE` to `true`, and configure production email delivery. The included Mailpit inbox at port `8025` is for testing. See the [deployment guide](DEPLOYMENT.md) for Portainer, configuration, and backups.
+
+## Everyday commands
+
+```sh
+# Check service status
+docker compose ps
+
+# View application logs
+docker compose logs -f diary
+
+# Stop the services while keeping your data
+docker compose down
+```
+
+For updates, back up your data first, then pull the latest code and rebuild:
+
+```sh
+git pull --ff-only
+docker compose up -d --build
+```
## Development
-Use Node.js 22 or later. Run `npm ci` and `npm run build` to build the frontend. `npm run dev` starts Vite; the backend requires the database and storage configuration supplied by Docker Compose.
+Use **Node.js 22.12+**.
-## Repositories
+```sh
+npm ci
+npm run dev
+```
-- [GitHub](https://github.com/donishki/Daymark)
-- [Gitea](https://git.ptbox.org/dasp/Daymark)
+The API requires PostgreSQL, MinIO, and the environment settings described in the [deployment guide](DEPLOYMENT.md). Use Docker Compose for a complete local stack.
-This public edition starts with clean source history. Personal deployment configuration and diary contents are excluded. Database and media content live in deployment volumes, not this source repository.
+Build the frontend with `npm run build`.
-Legacy storage keys and export identifiers are retained for compatibility with existing backups.
+## Links
+
+[GitHub](https://github.com/donishki/Daymark) · [Gitea](https://git.ptbox.org/dasp/Daymark) · [Report an issue](https://github.com/donishki/Daymark/issues) · [Planned improvements](TODO.md)
## License
-No open-source license has been selected. All rights reserved until a license is added.
+Copyright © 2026 Dario P.
+
+Daymark is licensed under the **GNU General Public License v3.0** (`GPL-3.0-only`). See [LICENSE](LICENSE) for the full terms.
diff --git a/docs/screenshots/daymark-diary.png b/docs/screenshots/daymark-diary.png
new file mode 100644
index 0000000..6bf89e9
Binary files /dev/null and b/docs/screenshots/daymark-diary.png differ
diff --git a/docs/screenshots/daymark-editor.png b/docs/screenshots/daymark-editor.png
new file mode 100644
index 0000000..4a333a9
Binary files /dev/null and b/docs/screenshots/daymark-editor.png differ
diff --git a/docs/screenshots/daymark-timeline.png b/docs/screenshots/daymark-timeline.png
new file mode 100644
index 0000000..ae5028d
Binary files /dev/null and b/docs/screenshots/daymark-timeline.png differ
diff --git a/package-lock.json b/package-lock.json
index 7cc4e00..1d6865f 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,11 +1,13 @@
{
"name": "daymark",
+ "license": "GPL-3.0-only",
"version": "1.18.1",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "daymark",
+ "license": "GPL-3.0-only",
"version": "1.18.1",
"dependencies": {
"@simplewebauthn/browser": "^13.3.0",
diff --git a/package.json b/package.json
index 6155359..358aa95 100644
--- a/package.json
+++ b/package.json
@@ -1,5 +1,6 @@
{
"name": "daymark",
+ "license": "GPL-3.0-only",
"private": true,
"version": "1.18.1",
"type": "module",