How jh-media-group/how-to-kick-saas works
This repository is not an application runtime; it is a GitBook-style documentation source for a SaaS business handbook. The “architecture” is primarily editorial and navigational: Markdown chapters, grouped into a hierarchical table of contents, with a small asset bundle for images and a few external links.
1. Core structure
The repo is organized as a book with topical sections such as validation, build process, pricing, acquisition, activation, and retention/attrition. Each top-level folder is a major chapter cluster, and each .md file is a page in the book.
2. Navigation layer
SUMMARY.md is the main navigation index for the whole book. Nested README.md files inside chapter folders act as section entry points and likely control how GitBook renders the chapter hierarchy.
3. Content domains
The content is split into the SaaS lifecycle:
• idea validation and market testing
• planning and costing
• product build process
• pricing and monetization
• acquisition and growth
• activation/onboarding
• support/community/retention
• business fundamentals and miscellaneous notes
This gives the repo a clear funnel-like structure from pre-build to post-launch growth.
4. Build-process subsystem
saas-build-process/ is the largest subsystem and is itself subdivided into planning, development steps, tooling, team roles, and “things to know.” This section reads like the operational backbone of the book, covering how a SaaS product is planned, estimated, built, tested, and launched.
5. Validation and pricing subsystems
validating-you-saas/ focuses on deciding whether the idea should exist and how to test it commercially. appraisement-pricing-your-saas/ focuses on pricing strategy, metrics, and customer segmentation. Together these sections define the commercial viability boundary before and after product build.
6. Growth and retention subsystems
acquisition-gaining-saas-users/, activiation/, and attrition-supporting-your-community-and-growing-your-business/ cover the customer lifecycle after launch: getting users, onboarding them, and keeping them engaged. These are the post-build growth and retention chapters, organized as separate operational stages rather than mixed into one section.
7. Supporting content and notes
the-business-of-saas/, who-and-how.md, forward.md, and notes/ provide framing, commentary, and side observations. These pages function as connective tissue between the major lifecycle sections rather than standalone subsystems.
8. Asset and media boundary
.gitbook/assets/ holds the static media used by the book, likely images or diagrams embedded in Markdown pages. There is no sign of dynamic media processing; assets are referenced directly from the documentation source.
9. External dependency boundary
The repo links out to Google Forms, contact pages, YouTube videos, LinkedIn, and several company websites. These are reference or conversion touchpoints, not integrated backend services. They matter only as outbound destinations from the book.
10. Technology profile
The repository is Markdown-first and GitBook-oriented. There is no application code, no database schema, and no server-side runtime in this tree. The effective “system” is a static knowledge base whose output is a navigable book about how to build and grow a SaaS company.
Main entry points: SUMMARY.md SUMMARY · saas-build-process.md Build Process · acquisition-getting-saas-users.md Acquisition · README.md Home
Components 24
Navigation
Book-level entry points and editorial glue.
Validation
Idea testing and go/no-go chapters.
- Validation · Main validation chapter for deciding whether the SaaS idea should exist.
validating-you-saas/validating-your-saas.md - Sales Validation · Validation via marketing-based and direct-sales style testing.
validating-you-saas/marketing-based-sales-saas/README.md - Validation Result · What success and failure look like after validation.
validating-you-saas/validation-success.md
Build
Planning, development, tooling, and team setup.
- Build Process · Overview of the SaaS build lifecycle.
saas-build-process/saas-build-process.md - Planning · Scope, costing, documents, and build estimation.
saas-build-process/planning/README.md - Build Steps · Core development stages from concept through launch.
saas-build-process/steps-to-developing-a-saas/README.md - Tools · Development and project tooling used during the build.
saas-build-process/tools/README.md - Build Team · Roles and responsibilities for the SaaS delivery team.
saas-build-process/your-build-team-explained/README.md
Pricing
Monetization strategy and customer value framing.
- Pricing · Pricing strategy and monetization chapter.
appraisement-pricing-your-saas/appraisement-saas-pricing.md - Pricing Page · The pricing page as the key commercial conversion surface.
appraisement-pricing-your-saas/your-most-valuable-page/README.md
Acquisition
Lead generation and user growth chapters.
- Acquisition · User acquisition and growth chapter.
acquisition-gaining-saas-users/acquisition-getting-saas-users.md - Automation · Marketing automation systems and lead handling.
acquisition-gaining-saas-users/marketing-automation-in-saas/README.md - Search Marketing · Organic search and content-led acquisition.
acquisition-gaining-saas-users/organic-search-marketing/README.md - Social Media · Paid and organic social acquisition experiments.
acquisition-gaining-saas-users/social-media-marketing/README.md
Activation
Onboarding and first-use experience.
- Activation · Activation and onboarding experience.
activiation/activation.md - Onboarding · New-user setup and first-use guidance.
activiation/onboarding.md
Retention
Support and community retention chapters.
- Support · Customer support and community retention chapter.
attrition-supporting-your-community-and-growing-your-business/supporting-your-saas-customers.md
Fundamentals
Business framing and connective commentary.
- Business Basics · Foundational SaaS business concepts and process framing.
the-business-of-saas/the-business-of-saas.md - Notes · Side observations and supporting commentary.
notes/notes-1.md - Who and How · Framing page for audience and approach.
who-and-how.md - Forward · Introductory framing and orientation.
forward.md
Assets
Static media referenced by the book.
- Assets · Static images and diagrams embedded in the handbook.
.gitbook/assets
Connections 25
- SUMMARY → Home: starts at · The table of contents anchors the book home.
- SUMMARY → Validation: links · Navigation entry for validation chapters.
- SUMMARY → Build Process: links · Navigation entry for build chapters.
- SUMMARY → Pricing: links · Navigation entry for pricing chapters.
- SUMMARY → Acquisition: links · Navigation entry for acquisition chapters.
- SUMMARY → Activation: links · Navigation entry for activation chapters.
- SUMMARY → Support: links · Navigation entry for retention chapters.
- SUMMARY → Business Basics: links · Navigation entry for fundamentals.
- Home → Forward: introduces · Front matter and orientation pages support the home page.
- Home → Who and How: frames · Audience and method framing.
- Validation → Sales Validation: branches to · Validation splits into sales-based testing.
- Validation → Validation Result: concludes with · Validation leads to success or failure outcomes.
- Build Process → Planning: organizes · Build begins with planning and costing.
- Build Process → Build Steps: organizes · Core development stages follow planning.
- Build Process → Tools: supports · Tooling underpins the build workflow.
- Build Process → Build Team: staffed by · Team roles explain who performs the work.
- Build Steps → Planning: depends on · Development is scoped and costed up front.
- Pricing → Pricing Page: focuses on · Pricing strategy centers on the pricing page.
- Acquisition → Automation: includes · Acquisition covers automation systems.
- Acquisition → Search Marketing: includes · Acquisition covers organic search.
- Acquisition → Social Media: includes · Acquisition covers social media marketing.
- Activation → Onboarding: extends into · Activation is operationalized through onboarding.
- Support → Assets: references · Retention chapters may embed static media and diagrams.
- Business Basics → Notes: connected by · Fundamentals are supplemented by notes and commentary.
- Business Basics → Forward: introduced by · Introductory framing precedes business fundamentals.