Skip to content

steilerDev/cornerstone

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

273 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cornerstone

Note

This project is completely written using an Agentic Developmen Workflow with Claude Code and Docker Sandbox VMs.

It is a playground to better understand how to fully utilize the coding capabilities of modern LLMs, while applying Software Engineering best practices to create quality and maintainable code. My plan is to write as little code as possible by hand, but rely on a set of agents to build this application.

The project scope is time-limited (I'm currently in need for this tool and probably won't be after) and feature limited - which is why I'm not necessarily concerned about long-term maintainability and/or overall code quality.

After having spend a couple of weeks on this project, I'm both blown away by the LLM capabilities, while still feeling that things don't move as fast and reliable as I would like them to be.

Key learnings so far:

  • In order to coding agents to produce good work, verification is very important.
  • Good work will cost a lot of tokens!
  • Clearly defining the process through skills and agents simplifies the UX for the developer and ensures coding happens along a happy path.
  • Parallel work is important - using git worktrees for this should be natively supported by coding agents.
  • Running coding agents on your host is dangerous! They can (and will) go wild and perform tasks that you would have never thought of and they are clever in bypassing restrictions. An isolated environment is crucial to provide agents with clear restrictions and reduce the blast radius in case something goes wrong - Coding Agent Governance will be a critical capability moving forward!
  • In order to follow a policy, it needs correct enforcement - nicely asking an agent to follow it will not always work: Make sure your CI, Repository and Deployment process have enforced quality gates with no way for the agent to bypass them .

Cornerstone

GitHub Release CI Docker Image

A self-hosted home building project management tool for homeowners. Track work items, manage dependencies, organize with tags, and collaborate with your household -- all from a single Docker container backed by SQLite. No external database or cloud service required.

Full documentation →

Features

  • Work Items -- CRUD, statuses, dates, assignments, tags, notes, subtasks, dependencies, keyboard shortcuts
  • Budget Management -- Budget categories, financing sources, vendor invoices, subsidies, overview dashboard with projections
  • Timeline & Gantt Chart -- Interactive Gantt chart with dependency arrows, critical path, zoom controls, milestones, and CPM-based auto-scheduling
  • Calendar View -- Monthly and weekly calendar grids with work items and milestones
  • Document Integration -- Browse and link documents from Paperless-ngx to work items and invoices
  • Authentication -- Local accounts with setup wizard, OIDC single sign-on
  • User Management -- Admin and Member roles, admin panel
  • Dark Mode -- Light, Dark, or System theme
  • Design System -- CSS custom property token system, consistent visual language

Quick Start

docker run -d \
  --name cornerstone \
  -p 3000:3000 \
  -v cornerstone-data:/app/data \
  steilerdev/cornerstone:latest

Open http://localhost:3000 -- the setup wizard will guide you through creating your admin account. See the full deployment guide for Docker Compose, reverse proxy, and OIDC configuration.

Roadmap

  • EPIC-02: Application Shell and Infrastructure
  • EPIC-11: CI/CD Infrastructure
  • EPIC-01: Authentication and User Management
  • EPIC-03: Work Items
  • EPIC-12: Design System Bootstrap
  • EPIC-05: Budget Management
  • EPIC-06: Timeline and Gantt Chart
  • EPIC-08: Paperless-ngx Integration
  • EPIC-04: Household Items
  • EPIC-07: Reporting and Export
  • EPIC-09: Dashboard and Overview
  • EPIC-10: UX Polish and Accessibility

Track live progress on the GitHub Projects board.

Documentation

Resource Description
Docs site User guides, deployment, getting started
GitHub Wiki Architecture, API contract, schema, ADRs
CLAUDE.md Agent instructions and project conventions

Contributing

Cornerstone is a personal project built primarily through an agentic development workflow. If you have questions or suggestions, feel free to open an issue.

License

This project is not currently published under an open-source license.

About

A self-hosted home building project management tool for homeowners.

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages