Selecting the Right Path for Your Architecture
Choosing an implementation method is a strategic decision based on your site's architecture and your team's development preferences
1. Implementation Decision Matrix
| Feature | Athos-Led (Managed) | Self-Led (Snap SDK) | Self-Led (Direct API) |
| Primary Build Team | Searchspring / Athos Engineers | Client or Agency Developers | Client or Agency Developers |
| Best For | Standard platforms (Shopify Liquid, BigCommerce Stencil, Magento) or custom stores supporting JS injection. | Modern frameworks (React, Vue, Next.js) where teams want a head start using pre-built logic. | High-security, heavy SSR, or bespoke headless sites requiring 100% data layer control. |
| Architecture Fit | Traditional Multi-page, Non-SPA | Headless | Complex SSR, Enterprise Headless, SPA, PWA, BC Catalyst, Shopify Hydrogen |
| Maintenance | Searchspring owns and updates the code. | Client owns and updates the code. | Client owns and updates the code. |
2. Key Technical Considerations
Headless Architecture (The "Injection" vs. "Native" Choice)
- Scenario A (JS Injection): If your headless frontend allows external scripts to target and populate specific "containers" or "divs" on a page, Athos-Led is a viable option.
- Scenario B (Native Integration): If your headless site is tightly coupled with a framework like React or Vue, a Self-Led approach is required. This ensures Searchspring functions as a native component within your codebase rather than an "outsider" script.
Single Page Applications (SPA) & PWAs
- The Challenge: SPAs handle navigation via pushState without a full page reload.
- The Recommendation: Self-Led (API). A native integration is required to stay in sync with your site's internal routing. Athos-led injection can cause "DOM collisions" or synchronization issues in SPA environments.
Server-Side Rendering (SSR)
- The Challenge: If your SEO strategy requires search results to be rendered on the server before reaching the browser.
- The Recommendation: Self-Led API. This allows your server to communicate directly with Searchspring to deliver fully indexed HTML to search engines.
Traditional Platforms (Shopify Liquid / BC Stencil / Hyvä)
The Recommendation: Athos-Led. Our team manages the full implementation, injecting the Searchspring UI directly into your theme.
Comments
0 comments
Please sign in to leave a comment.