Guides
Use and adapt ZaneAI
Use and adapt ZaneAI: A real-estate application ecosystem connecting people, properties, and data across an npm-workspace monorepo.
Use the documented interfaces and source layout for ZaneAI. The sections below retain the README’s examples and configuration details.
Development Commands
| Command | Action |
|---|---|
npm run start | Start the mobile application. |
npm run convex | Run the Convex dev server and codegen. |
npm run typecheck | Run TypeScript validation across the monorepo. |
npm run lint | Execute ESLint checks. |
npm run portal:build | Build the Portal Next.js app. |
npm run web:build | Build the Web Next.js app. |
npm run agent:smoke | Run AI agent smoke tests. |
Repository Architecture
This is a high-performance monorepo managed with npm workspaces, designed for speed, modularity, and cross-platform consistency.
Applications (apps/)
| Path | Project | Description | Tech Stack |
|---|---|---|---|
/apps/mobile | Zane Mobile | The companion app for modern agents. | Expo, React Native |
/apps/portal | Zane Portal | High-fidelity institutional interface. | Next.js, Framer Motion |
/apps/web | Zane Web | Client-facing interactive experience. | Next.js, Tailwind CSS |
Infrastructure & Shared Core (packages/)
/convex: The AI-native backend. Real-time subscriptions, serverless functions, and vector search./packages/ag-ui: The "Pure Canvas" design system. High-precision primitives for web and mobile./packages/zayon-assistant-protocol: Unified communication layer for AI interactions.
Commands in the root manifest
The captured package.json declares the following scripts. Run them from the directory containing that manifest.
| Command | Script |
|---|---|
npm run start | npm --workspace apps/mobile run start |
npm run android | npm --workspace apps/mobile run android |
npm run ios | npm --workspace apps/mobile run ios |
npm run typecheck | npm --workspace apps/mobile run typecheck |
npm run test | npm --workspace apps/mobile run test |
npm run lint | npm --workspace apps/mobile run lint |
Troubleshoot a local change
- Reproduce the smallest example from the quick-start guide.
- Compare required configuration and dependency versions with the README.
- Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.
Source and help
Source captured: 2026-10-11