Ethos is the monorepo for the Ethosism canon. It keeps the core Ethos book, companion domain frameworks, practice material, and strategy documents in one GitHub repository while preserving a separate source tree and URL namespace for every book.
- Read the core book at books/ethos.
- Browse the full library in books.
- Work on the public website in web.
- Use the repo-local writing guidance in books/ethos/docs/writing-guide.md.
Each book lives under books/<book-slug>/.
books/ethos/: the foundation text of Ethosism.books/commons-framework/: shared life, institutions, households, and civic reliability.books/discernment-framework/: truth, judgment, belief, evidence, and correction.books/fidelity-framework/: love, loyalty, trust, family, sexuality, and repair.books/formation-framework/: character, education, habit, example, and generational formation.books/gathering-framework/: Ethosist shared practice, service, mentorship, and transmission.books/governance-framework/: citizenship, public power, policy, taxation, and constraint.books/justice-framework/: rights, law, due process, accountability, restitution, and mercy.books/stewardship-framework/: money, property, body, home, tools, resources, and inheritance.books/vocation-framework/: useful work, craft, enterprise, livelihood, and contribution.books/industrious-framework/: daily systems and practical living.books/ethosism-intro-book/: concise introduction to Ethosism.books/ethos-business-plan/: business plan and investor pitch material.
The old top-level chapters/, docs/, and src/ directories are retained for compatibility while the website and future consolidation work move toward books/ as the source of truth.
The Astro site in web/ publishes the library to ethosian.info.
/books: full Ethosism library./books/<book-slug>: one book's reading sequence./books/<book-slug>/chapters/<chapter-slug>: namespaced chapter route./chapters: legacy route for the core Ethos book.
Chapter slugs are namespaced by book, so repeated filenames such as 00-introduction.md do not collide.
Imported books should not contain nested Git repositories or generated dependency/build artifacts. Exclude at least:
.git/node_modules/dist/output/.DS_Store- lockfiles generated by the old per-book package installs unless a specific book still needs them
Ethosism is a secular, theology-compatible worldview that provides explicit guidance on how to live with purpose, integrity, and long-term responsibility. It grounds moral claims in observable consequences, role reversal, honest alignment between values and behavior, and durable contribution across self, relationships, society, and future generations.
Production deploys run through GitHub Actions on every push to main.
- Workflow:
.github/workflows/deploy.yml - Domain:
ethosian.info - Server:
deploy@77.42.30.181 - Site directory:
/opt/ethos/site - Required secret:
VPS_SSH_KEY
The workflow builds the Astro static site, syncs web/dist/ to the VPS, writes the Caddy site config for ethosian.info, reloads Caddy, verifies expected static files exist on the server, and smoke-tests the public HTTPS routes.