Complete guide to all documentation in the Candlestick library.
Start here if you're new:
- README.md - Main documentation, quick start, API overview
- examples/ - Working code examples
- CHANGELOG.md - See what's new in v1.1.0
Main library documentation
- Quick Start (CommonJS, ESM, TypeScript)
- Installation
- Usage examples
- All 19 patterns documented (29 variants)
- Pattern chaining
- Data validation
- Plugin system basics
- Streaming API
- FAQ
Technical architecture guide
- Design principles
- Directory structure
- Core components
- Data flow
- Performance optimizations
- Pattern implementation guidelines
- Future considerations
Release history
- v1.2.0 (2025-10-18) - Latest
- 3 new patterns (Marubozu, Spinning Top, Tweezers)
- Streaming API for large datasets
- Property-based testing
- 306 tests, 99.75% coverage
- v1.1.0 (2025-10-17)
- 6 new patterns
- ESM support, TypeScript, Plugin system
- Previous versions
Future plans
- Near-term goals (mostly ✅ completed)
- Medium-term goals (🔜 planned)
- Long-term goals
- Community feedback
Plugin system complete guide
- API reference
- registerPattern(), unregisterPattern(), etc.
- Pattern detection functions
- Metadata system
- Integration with patternChain
- Best practices
- Examples
How to contribute
- Bug reports and feature requests
- Coding standards
- Running tests
- Linting & formatting
- Pull request checklist
- Adding new patterns guide
Community standards
- Expected behavior
- Enforcement
Security policy
- Reporting vulnerabilities
- Security best practices
Examples guide
- How to run examples
- Available examples (14 total):
- Single candle patterns (3)
- Two candle patterns (4)
- Multi-pattern detection (5)
- Utilities (1)
- Metadata (1)
candlestick/
├── README.md # Start here
├── ARCHITECTURE.md # Technical details
├── CHANGELOG.md # What's new
├── ROADMAP.md # Future plans
├── CONTRIBUTING.md # How to contribute
├── docs/
│ ├── README.md # Docs index
│ └── PLUGIN_API.md # Plugin guide
├── examples/
│ ├── README.md # Examples guide
│ └── *.js, *.mjs # 11 working examples
└── types/
└── index.d.ts # TypeScript definitions
For Users:
For Developers:
For Traders:
For Maintainers:
docs/ Directory:
The docs/ directory contains specialized guides:
- PLUGIN_API.md - Complete plugin development guide
- CLI_GUIDE.md - Command-line tool documentation
- Total Docs: 10 markdown files (essential documentation)
- Examples: 14 working examples
- Patterns Documented: 19 unique patterns (29 variants)
- API Functions Documented: 53+
- Tests: 306 (99.75% coverage)
- CLI Commands: 1 (candlestick)
- Metadata System: Complete (confidence, type, strength, direction)
- Streaming API: Available for large datasets
- Last Updated: October 18, 2025 (v1.2.0)
Patterns:
- See README.md - Pattern Descriptions
- See examples/ for code
TypeScript:
ESM:
Plugins:
Validation:
Metadata:
CLI:
- See docs/CLI_GUIDE.md
- Run
candlestick --help
Contributing:
Need help? Open an issue on GitHub.