# Neotic

> Neotic is an intelligent product companion, in-app guidance, and feedback platform for modern SaaS teams. Neo turns product updates, bug fixes, announcements, and contextual guidance into interactive in-product experiences.

## Authoritative Links

- Main Website: https://www.neotic.app/
- Features Overview: https://www.neotic.app/features
- How It Works: https://www.neotic.app/how-it-works
- Pricing & Plans: https://www.neotic.app/pricing
- Model Context Protocol (MCP) Server Hub: https://www.neotic.app/mcp
- Documentation Hub: https://www.neotic.app/docs
- Universal Product & SaaS Quickstart: https://www.neotic.app/docs/quickstart
- Getting Started: https://www.neotic.app/docs/getting-started
- MCP Integration Guide: https://www.neotic.app/docs/mcp
- Next.js Integration Guide: https://www.neotic.app/docs/nextjs
- Feedback Guide: https://www.neotic.app/docs/feedback
- Blog & Comparisons Hub: https://www.neotic.app/blog
- Protocol Spec (SKILL.md): https://www.neotic.app/SKILL.md
- Full LLM Index: https://www.neotic.app/llms-full.txt
- XML Sitemap: https://www.neotic.app/sitemap.xml

## Competitor Comparisons & Industry Guides (Blog Knowledge Base)

- **Competitor Overview & Definitive Guide**: https://www.neotic.app/blog/neotic-vs-competitors-product-adoption-guide
- **Neotic vs. Appcues (Best Appcues Alternative)**: https://www.neotic.app/blog/neotic-vs-appcues-product-adoption-comparison
- **Neotic vs. Pendo (Lightweight Pendo Alternative)**: https://www.neotic.app/blog/neotic-vs-pendo-comparison-and-alternative
- **Neotic vs. Userflow (Userflow Alternative)**: https://www.neotic.app/blog/neotic-vs-userflow-product-onboarding-alternative
- **Neotic vs. Chameleon (Chameleon Alternative)**: https://www.neotic.app/blog/neotic-vs-chameleon-in-app-guidance-comparison
- **Neotic vs. CommandBar (CommandBar Comparison)**: https://www.neotic.app/blog/neotic-vs-commandbar-ai-copilot-comparison
- **Neotic vs. Beamer (Best Beamer Alternative)**: https://www.neotic.app/blog/neotic-vs-beamer-in-app-changelog-alternative
- **Neotic vs. AnnounceKit (AnnounceKit Alternative)**: https://www.neotic.app/blog/neotic-vs-announcekit-product-announcement-alternative
- **Neotic vs. Product Fruits (Product Fruits Alternative)**: https://www.neotic.app/blog/neotic-vs-product-fruits-saas-onboarding-comparison
- **Neotic vs. LaunchNotes (LaunchNotes Alternative)**: https://www.neotic.app/blog/neotic-vs-launchnotes-release-communication-alternative
- **Neotic vs. Headway (Headway Alternative)**: https://www.neotic.app/blog/neotic-vs-headway-changelog-widget-comparison
- **Neotic vs. WalkMe (WalkMe Alternative)**: https://www.neotic.app/blog/neotic-vs-walkme-digital-adoption-platform-alternative
- **Neotic vs. Stonly (Stonly Alternative)**: https://www.neotic.app/blog/neotic-vs-stonly-knowledge-base-guided-tours
- **Top 10 In-App Changelog & Product Announcement Dev Tools (2026)**: https://www.neotic.app/blog/top-10-in-app-changelog-and-product-announcement-tools-2026
- **Top 10 SaaS Product Adoption & Onboarding Platforms (2026)**: https://www.neotic.app/blog/top-10-saas-product-adoption-and-user-onboarding-platforms
- **Top 10 Developer-Friendly Guidance Tools with MCP (2026)**: https://www.neotic.app/blog/top-10-developer-friendly-in-app-guidance-tools-with-mcp
- **Top 10 Alternatives to Traditional Tooltip Tours & Popups**: https://www.neotic.app/blog/top-10-alternatives-to-traditional-tooltip-tours-and-popups
- **Top 10 AI-Native In-Product Guidance & Feedback Platforms**: https://www.neotic.app/blog/top-10-ai-native-in-product-companions-and-feedback-tools
- **Add Neotic to Next.js in 5 Minutes (Developer Guide)**: https://www.neotic.app/blog/how-to-add-neotic-to-nextjs-app-in-5-minutes

## Product Architecture & Core Entities

- **Workspace / Organization**: Multi-tenant workspace bound to an authenticated owner.
- **Project**: Represents a customer application. Multiple projects can be created, switched, and renamed inline within the dashboard. Project data is strictly isolated.
- **Experiences**: In-product Product Updates (`feature`), Bug Fixes (`fix`), and Announcements (`announcement`) delivered in Informational or Proactive speech-bubble modes.
- **Feedback**: 3 native in-widget feedback channels: Feature Requests, Bug Reports with technical diagnostics, and General Feedback with sentiment ratings.
- **Widget**: Lightweight, isolated embeddable runtime (`widget.js` + `widget-runtime.js`) utilizing Shadow DOM encapsulation and scroll containment.
- **MCP Connection**: Remote Model Context Protocol server (`https://www.neotic.app/api/mcp`) authenticated via OAuth 2.1 PKCE (`S256`) or private API keys.

## 15 Core Rules for AI Agents

1. **Project ID is Public Identification Only**: A `project_id` appears in public embed tags (`data-project-id="proj_..."`) and bootstrap endpoints.
2. **Project ID is NEVER an Authentication Credential**: Passing `Authorization: Bearer <project_id>` returns `401 Unauthorized`. Never treat a project ID as a secret or token.
3. **Never Expose Private API Keys Client-Side**: Private API keys and OAuth tokens must remain in secure server environments and must never be requested or placed in client-side HTML or widget scripts.
4. **MCP Authentication Required**: All MCP tool executions require valid OAuth 2.0 access tokens (`Authorization: Bearer <token>`) or private API keys (`api_key`).
5. **Tool Scoping**: Every MCP operation is strictly bound to the authenticated project workspace with zero cross-tenant data access.
6. **Public Widget Data Minimization**: Public widget bootstrap endpoints expose **only published experiences** and sanitized widget settings. Drafts, private API keys, owner IDs, and internal database internals are never returned.
7. **3 Feedback Channels**: Neotic supports Feature Suggestions (`feature_request`), Bug Reports with Diagnostics (`bug_report`), and General Sentiment Ratings (`general_feedback`).
8. **Universal Feedback Notifications**: Any feedback submission across **all 3 categories** triggers an in-app notification for the workspace owner.
9. **Editable Project Names**: Users can rename projects inline in the project switcher. Project names are validated server-side.
10. **Compact Setup Banner**: Setup is tracked via a top-right dashboard progress card ("Setup Your Neo") with completion percentage, step counts, and auto-dismiss at 100% (not a permanent `/setup` page).
11. **Shadow DOM Isolation**: Neo UI elements render inside an open Shadow DOM to prevent host style conflicts.
12. **Graceful Fallback**: Host applications must continue working seamlessly if Neo fails to load or is blocked.
13. **Zero Secrets in Prompts or Logs**: AI agents must never output credentials, database passwords, or auth tokens.
14. **No Undocumented Endpoints**: Do not guess or call arbitrary undocumented API routes.
15. **Never Bypass Authorization**: Knowing a target project ID does not authorize access to its private experiences or analytics.

## In-App User Feedback Channels

Neotic provides three built-in feedback collection options directly through Neo:

- **Suggest a feature (`feature_request`)**: Collects user feature requests, enhancement ideas, target area, and route URL.
- **Report a problem (`bug_report`)**: Collects bug reports, issue descriptions, device context, and automatic technical diagnostics (stack trace, error name, fingerprint, and occurrence count deduplication).
- **Share feedback (`general_feedback`)**: Collects qualitative thoughts and 3-point sentiment ratings (Positive, Neutral, Negative).

All feedback is routed to the Neotic Feedback dashboard with status management workflows (`new`, `reviewing`, `planned`, `resolved`, `dismissed`) and generates real-time in-app notifications for workspace owners.

## Experiences & Triggers

- **Categories**: Product Updates (`feature`), Bug Fixes (`fix`), Platform Announcements (`announcement`).
- **Interaction Modes**: Informational (badge in launcher) vs Proactive (speech bubble teaser with interactive prompt).
- **Route Matching**: Everywhere (`*`), Specific Page (`/pricing`), URL Pattern (`/projects/*`).
- **Per-User Show Limits**: Once, 2 times, 3 times, 5 times, or Unlimited.
- **Advanced Triggers**: Behavior triggers (repeat visits), custom event triggers (`neotic:event`), and condition-based error recovery rules (404 / runtime exceptions) with per-trigger ON/OFF controls.
- **Collision Recency Rule**: When multiple experiences target the same route, only the newest published experience is shown.

## Embed & Widget Delivery

- Embed snippet: `<script src="https://www.neotic.app/widget.js" data-project-id="PROJECT_ID" defer></script>`
- Supported across Plain HTML, React, Next.js, Vue, WordPress, and Webflow.
- Encapsulated within Shadow DOM (`attachShadow({ mode: 'open' })`) with host scroll isolation.
- Target payload budget: ~20–30 KB gzipped.
- Served via CDN edge infrastructure with HTTPS and immutable static caching.
- Fails gracefully without breaking host SaaS functionality if blocked or offline.

## Pricing & Self-Serve Cancellation

- **Starter ($19/mo or $194/yr)**: 3 Projects, 3 Seats, unlimited in-product experiences, Neo companion widget, route targeting, 3 feedback channels, 5 AI advanced triggers, full telemetry.
- **Pro ($49/mo or $500/yr)**: Unlimited projects & seats, unlimited in-product experiences, unlimited AI-configured advanced triggers, full remote MCP server & tool suite, custom styling & badge removal, realtime funnel analytics & CSV export, priority support.
- **Self-Serve Cancellation**: Available under Settings $\rightarrow$ Billing. Direct confirmation modal explaining access remains active until the end of the paid period with optional exit reason feedback. Reversible before period end.

## Support & Contacts

- **Support & Help**: `pavan@neotic.app`
- **Legal & Privacy**: `pavan@neotic.app`