Skip to content
Projekte

victor-falcon/plain-week has 79 GitHub stars and 5 forks. GitHot measured +13 in 7 days. Last checked 2026-11-18 11:50 UTC. Last push 2026-11-17.

So werden diese Zahlen gemessen

What you can do

  • ⚡ Fast entry. Click an empty row, type, press Enter, keep typing. "17:30 Gym" sets the time for you.
  • 🔁 Recurring tasks. Repeat every N days, weekly on any weekdays or monthly on a day, with an optional end date. Change or move one occurrence, or this and all the following ones.
  • 🎨 Colors, notes and subtasks. Eight colors, plain-text notes and a checklist, all in one task dialog.
  • ↔️ Drag and drop. Reorder within a day, move across days and to Someday, or drop on the screen edge to send a task to another week. Mouse, touch and keyboard.

Gemessener Sternzuwachs

in 24h
Aktualisierung verzögert
in 7 days
+13
in 15 days
Verlauf wird gesammelt
in 1 month
Verlauf wird gesammelt

Nettoänderungen in überlappenden Zeiträumen, keine Tagessummen. Fehlende Messwerte bleiben leer. Sterne zeigen Interesse, nicht Qualität.

Über uns

Minimalistischer Open-Source-Wochenplaner mit Aufgabenliste. Kostenlos, unter MIT-Lizenz und selbst hostbar.

Selbst gehostet

README.md

Original

Plain Week: your week, plain and simple. A minimal weekly planner and to-do list.

Your week, plain and simple.
One week on one screen. Local-first and private: no account needed, your tasks stay in your browser and it works offline. Free and MIT licensed.
Free in your browser and on your own server; optional sync across devices on plainweek.eu is a paid plan.

Plain Week in action: typing tasks straight into the days of the week, then dragging them between days

Deutsch | Español | Français | 日本語 | 한국어 | Português | Русский | 中文

License: MIT Latest release Tests Docker image on GHCR

Get started

  • 🌐 Use it now at plainweek.eu. Open it and start planning, no sign-up needed.

  • 🐳 Run it with Docker. One container, SQLite on a volume, no other services. Then open http://localhost:8080.

    docker run -d -p 127.0.0.1:8080:8080 -v plainweek-storage:/app/storage \
      -e APP_URL=http://localhost:8080 -e APP_KEY="base64:$(openssl rand -base64 32)" \
      ghcr.io/victor-falcon/plain-week:latest
    
  • 🚀 Deploy on Coolify. Create a Docker Compose Empty resource, paste the template, set the domain of the plainweek service and deploy (details).

⭐ If Plain Week is useful to you, a star helps others find it. Ideas, questions or feedback? Say hi in GitHub Discussions.

Features

  • ⚡ Fast entry. Click an empty row, type, press Enter, keep typing. "17:30 Gym" sets the time for you.
  • 🔁 Recurring tasks. Repeat every N days, weekly on any weekdays or monthly on a day, with an optional end date. Change or move one occurrence, or this and all the following ones.
  • 🎨 Colors, notes and subtasks. Eight colors, plain-text notes and a checklist, all in one task dialog.
  • ↔️ Drag and drop. Reorder within a day, move across days and to Someday, or drop on the screen edge to send a task to another week. Mouse, touch and keyboard.
  • 🖱️ Right click for the rest. A context menu to color, duplicate, delete or move a task to tomorrow, next week or Someday, with undo.
  • ⌨️ Keyboard shortcuts. ← / → to change weeks, T to jump back to today.
  • 📴 Offline-first and installable. Data lives in IndexedDB; the app loads and works without a connection and installs as an app (PWA).
  • 🔄 Optional account and sync. Start as a guest, fully local. Create an account on your own server, or on plainweek.eu (paid), to sync between devices; your local work comes with you.
  • 📦 Export and import. With an account, download all your tasks as JSON from Settings › Data and bring them back on any instance.
  • 🌗 Light and dark mode, right-to-left layouts.
  • 🏠 Self-hosting in one container. A Docker image on GHCR, a Coolify template, SQLite and no other services.

Plain Week: the week view in light mode

Dark mode Task dialog
The week view in dark mode The task dialog
Repeat every N days Right-click menu
The repeat options of a task The task context menu
Export and import Task dialog, dark
Settings › Data: export and import The task dialog in dark mode
Phone, light Phone, dark
Phone, light Phone, dark

Local development

Requirements: PHP 8.3+ (8.5 recommended), Composer, bun 1.3+, and Node.js 24+.

git clone https://github.com/victor-falcon/plain-week.git
cd plain-week
composer setup      # install dependencies, create .env, generate key, migrate SQLite, build assets
composer run dev    # serve the app, queue worker, logs and Vite

Then open http://127.0.0.1:8000.

Before pushing, run what CI runs:

composer ci:check   # JS lint/format, TS types, JS tests, Pint, PHPStan, Pest
bun run build       # production assets

Self-hosting

One container, SQLite on a volume, no other services: the docker run line in Get started is all it takes. There is also a Coolify template, a docker-compose.yml for any server and a guide for running it without Docker, plus every environment variable (email, Google Calendar, notifications): see docs/self-hosting.md.

Documentation

See docs/ for the architecture (offline-first and the sync contract), the style guide, the stack and the conventions, and CHANGELOG.md for what changed in each release.

License

MIT