ObsiKO ObsiKO Docs

Project View 🗂️

If Bases is "a table that collects notes", the project view turns one base into a project command center — under a home header with cover, progress and deadline, it stacks the episode table, character cards, a kanban board and a progress chart.

← Home: ObsiKO 101 · Up: Bases (Data Tables)


What is it? 🤔

The project view is one of the five Bases view types (table · cards · kanban · chart · project): a dashboard home that arranges the other views of the same base as "sections". Your data still lives in each note's frontmatter — the .base file is just the assembly manifest, so backup, sync and Obsidian round-trips stay free.

Creating one ➕

Hover New Project ▸ in the explorer's folder button dropdown (or use the command palette) and pick the scope (whole vault / folder / tag). Choose a project template and it's created instantly — just rename it in the tree. An existing base can also switch via the view menu (⌄ on the tab) → As project.

The template you pick pre-builds views, property scaffolding and the progress rule:

Template What you get
Standard project Status kanban for tasks · source & memo cards · status donut
Blank project Home + table view
Web novel Episodes table (status) · character cards · status donut · done = "done"
Reading log Library table (status·rating) · ratings chart · done = "finished"
Research Sources table (status·source) · memo cards · done = "done"
Work Status kanban for tasks (todo/doing/done pinned) · meeting cards · status chart
Dev set Status kanban for features (todo/doing/review/done — one extra column) · bug table (date) · log & docs cards
Trip planning Itinerary table (date·status) · place cards
Blog & content Posts table (status·published) · idea cards · done = "published"
Study & exams Units table (status) · question cards · status chart

An empty vault is fine — each section's + creates a note pre-filled with that section's conditions (type, tags…), so the board runs from day one.

The home screen 🏠

Top to bottom: header → info note → stat cards → sections.

Editing project info ✎

The ✎ button opens a form — name, description, status, due date (date picker), info note (typing shows the vault note list, jamo search included), cover path, and progress property + done value, all at once. Status is a choice dropdown — pick from Planning · In progress · On hold · Done · Dropped, and if you need something else use 'Custom…' to enter any name (your existing free-text values are preserved too). For the cover you can skip the form: click the cover box, pick an image, and it's saved into the vault's assets/.

Working with sections 🧩

Kanban board 🧮

Kanban works both as a project section and as a dedicated view (As kanban in the view menu) — usage matches chapter 12. Drag cards to change status (press-hold on phone/iPad), + in a column header creates a note in that status, Columns manages order and empty columns, and right-clicking a card edits properties in place. The work template starts with a 3-column board on Home; the dev set adds a fourth, review.

✨ AI status briefing

The ✨ button gathers counts, progress, per-section numbers and recent items, and asks AI for a 3–5 sentence briefing plus 1–2 next actions, shown above the home. The briefing is saved, so it stays put even after you edit the project or restart the app, until you re-brief with ✨ (the creation time is shown too). Like the info note, you can fold it away with ▾/▸, and the collapsed state is remembered. Needs a chat API key or the desktop agent login.

Overview on the Dashboard 📊

On the Dashboard, add a board → 🗂️ Projects overview: every project in the vault in one card with name · status chip · D-day · progress bar. Click a row to open it. Due dates also appear on the Calendar panel and the dashboard calendars as 🗂️ entries (orange dot), right next to your tasks.

Curious about the source? </> 🧑‍💻

Project info lives in a top-level project: block (an ObsiKO extension):

filters:
  and:
    - file.inFolder("novel/snow")
project:
  name: Snow
  description: Romance fantasy, twice a week
  status: ongoing
  due: 2026-12-31
  info: novel/plan.md
  progress:
    prop: status
    done: done
views:
  - type: project
    name: Home
    stats:
      - label: Done
        agg: count
        where: status == "done"
    sections:
      - view: Episodes
        limit: 5
      - view: Characters
  - type: table
    name: Episodes

Good to know 💡


← Previous: Bases (Data Tables) · Home · Next: Library & Reading Log