Skip to content
Proyectos

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.

Cómo se miden estas cifras

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.

Crecimiento de estrellas medido

in 24h
Actualización retrasada
in 7 days
+13
in 15 days
Recopilando historial
in 1 month
Recopilando historial

Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.

Acerca de

Planificador semanal y lista de tareas minimalistas de código abierto. Gratis, con licencia MIT y alojable en tus propios servidores.

Autoalojamiento

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