Overview
The Developer Guide provides a technical roadmap for contributors and plugin authors. It details the project structure, local environment setup, and the interaction between the state management layer and core cryptographic services.
This section focuses on implementation details, API surfaces, and development workflows. While the Architecture section defines the conceptual design and threat model, this guide provides the practical instructions necessary to extend the application or contribute to its core logic.
Reading Order
To begin developing for WebStray Authenticator, it is recommended to follow this sequence:
- Development Environment – Tooling, setup process, and development workflow.
- Project Structure – Project structure, architectural layers, and module ownership.
- Internal Services – Core utilities for database management, cryptography, and data portability.
- State Layer – Zustand stores and their functional roles.
- Plugin SDK – Technical reference for components and core API.
- Plugin Lifecycle – Discovery, slot registration, and teardown processes.
- Plugin Security – Trust model, data handling rules, and UI/UX boundaries.
- First Plugin – Building your first plugin.
- Testing & Quality – Manual verification matrix and pre-release checklist.
Summary
The development workflow combines standard web tooling with the NW.js runtime. By adhering to the established modular structure and utilizing the provided SDK, developers can build secure, consistent features that respect the application's core security boundaries.