How oliveryh/clear-habits works
Project type and purpose
• This is a full-stack, keyboard-driven task manager (“Clear Habits”) with two major client versions (v1 and v2) and a GraphQL/Postgres backend.
• v2 (“client-ui-thing”) is built on Nuxt 3 + UI Thing + Apollo/GraphQL.
• v1 (“client”) is built on Vue 2 + Quasar + Apollo/GraphQL.
• The backend (“server-postgraphile”) uses PostGraphile to auto-generate a GraphQL API on top of PostgreSQL.
File structure
• Top-level directories:
– client-ui-thing → Nuxt 3 / UI Thing frontend (v2)
– client → Vue 2 / Quasar frontend (v1)
– server-postgraphile → Node.js server using PostGraphile + migrations + tests
– conf → environment and deployment templates (Ansible, Nginx)
– fasthtml_apps & reflex_apps → supplementary Python/Reflex micro-apps (not part of core)
• Key patterns:
– “gql” folders and .gql files in both frontends → Apollo GraphQL client
– migrations + SQL → database schema evolution
– .github/workflows → CI/CD pipelines for test & deploy
README for additional insights
– v1: Quasar UI → Apollo → PostGraphile → PostgreSQL
– v2: Nuxt 3 + UI Thing → Apollo/Codegen → PostGraphile → PostgreSQL