vanilla-js-architect

What problem does it solve?

Developers often write vanilla JavaScript without a clear architectural pattern, leading to tangled code, poor testability, and hard maintenance. This primer provides a disciplined structure that separates concerns and enables scalable growth without relying on frameworks.

Core Features & Use Cases

• Separation of concerns across Core (pure logic), UI (DOM and rendering), App (orchestration), and Data (persistence) to keep code modular and testable.
• Pure functions first approach with explicit inputs/outputs to enable easy testing and reasoning.
• JSDoc-based typings and approachable patterns that ease onboarding for new developers and facilitate migration to frameworks when needed.
• Practical patterns and example components to build small-to-medium web apps without tooling, while preserving testability and maintainability.

Quick Start

Create a new project structure that separates core logic, UI, app orchestration, and data layers, implement a small example module using pure functions and JSDoc, then run tests.