# macro | Macro | Knowledge Base | Instagit

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

GitHub Stars: 2.6k

Repository: https://github.com/macro-inc/macro

---

## Articles

### [Key Files for Understanding Macro Development in the Macro Repository](/macro-inc/macro/what-are-key-files-for-understanding-macro-development)

Unlock macro development in the macro repository by exploring key files for workspace config Cargo.toml shared infrastructure and microservice implementations.

- Tags: getting-started
- Published: 2026-08-21

### [What Is the `just check` Command in Macro? A Complete Guide to Local Verification](/macro-inc/macro/what-is-purpose-of-just-check-command-in-macro)

Discover the `just check` command in Macro. This powerful tool locally verifies code quality with formatting, linting, and type-checking, ensuring clean commits effortlessly.

- Tags: how-to-guide
- Published: 2026-08-21

### [Frontend Code Conventions in Macro: A Complete Style Guide for TypeScript and Vite](/macro-inc/macro/what-are-frontend-code-conventions-in-macro)

Discover Macro's frontend code conventions. Enforce strict TypeScript, ESLint, Vite, Vitest, and Prettier rules for absolute imports, kebab-case files, and type safety in apps web.

- Tags: best-practices
- Published: 2026-08-21

### [How to Access Environment Variables in Macro: The Complete Guide to macro_env_var](/macro-inc/macro/how-should-environment-variables-be-accessed-in-macro)

Discover how to access environment variables in Macro using the macro_env_var crate. Learn about compile-time validation, optional handling, and secure secret management for your Macro project.

- Tags: how-to-guide
- Published: 2026-08-21

### [How Macro Handles Errors in New Code: The `rootcause` Pattern Explained](/macro-inc/macro/how-does-macro-handle-errors-in-new-code)

Learn how Macro handles errors in new Rust code using the rootcause crate. Discover Result<T, Report> types, domain-specific error codes, and automatic tracing.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Perform Database Queries in Macro: SQLx Compile-Time Macros Explained](/macro-inc/macro/what-is-preferred-method-for-database-queries-in-macro)

Discover how Macro utilizes SQLx compile-time macros like query! for type-safe database queries. Catch errors early and ensure schema validation for robust applications.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Generate IDs in Macro Rust Code: UUIDv7 Patterns and Examples](/macro-inc/macro/what-is-correct-way-to-generate-ids-in-macro-rust-code)

Learn to generate UUIDv7 IDs in Rust macro code using macro_uuid generate_uuid_v7. Explore patterns and examples from the macro-inc/macro repository.

- Tags: how-to-guide
- Published: 2026-08-21

### [Why Macro Uses UUIDv7 for IDs: Time-Ordered Distributed Identifiers](/macro-inc/macro/why-does-macro-use-uuidv7-for-ids)

Macro uses UUIDv7 for IDs to enable time-ordered, distributed identification. Discover how this approach sorts lexicographically and removes coordination overhead in your services.

- Tags: deep-dive
- Published: 2026-08-21

### [How Data Flows from Client to Database in the Macro Platform](/macro-inc/macro/how-does-data-flow-from-client-to-database-in-macro)

Discover how data flows client to database in Macro. Learn about Axum routing, middleware authentication, domain services, and SQLx queries to PostgreSQL.

- Tags: architecture
- Published: 2026-08-21

### [What Database Does Macro Use and What Data Does It Store?](/macro-inc/macro/what-database-is-used-for-macro-and-what-data-does-it-store)

Discover what database Macro uses. Macro leverages PostgreSQL (MacroDB) to store crucial data like documents, user accounts, projects, and communication history.

- Tags: internals
- Published: 2026-08-21

### [How the Macro Backend Implements Hexagonal Architecture](/macro-inc/macro/how-is-macro-backend-structured-using-hexagonal-architecture)

Discover how the Macro backend leverages hexagonal architecture in Rust to isolate domain logic from infrastructure concerns. Learn about ports and adapters for clean service structure.

- Tags: architecture
- Published: 2026-08-21

### [Technologies Used in Macro Microservices: Complete 2024 Stack Breakdown](/macro-inc/macro/what-technologies-are-used-in-macro-microservices)

Explore the technologies powering Macro microservices in 2024. Discover the Rust stack including Axum, async-graphql, PostgreSQL, Redis, OpenSearch, AWS, Pulumi, SolidJS, and Tauri.

- Tags: architecture
- Published: 2026-08-21

### [Macro Architecture Overview: Rust-Based Cloud Storage Microservices Explained](/macro-inc/macro/what-is-macro-architecture-overview)

Explore the Macro architecture, a Rust-based cloud storage microservices platform. Learn how it uses PostgreSQL, S3, and AWS Lambda for efficient data and document processing.

- Tags: architecture
- Published: 2026-08-21

### [How to Run Multiple Macro Stacks in Parallel](/macro-inc/macro/how-to-run-multiple-macro-stacks-in-parallel)

Learn how to run multiple macro stacks in parallel by exporting unique MACRO_STACK_NAME environment variables. This ensures isolated Docker networks and Pulumi state files for efficient parallel execution.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Update the SQLx Query Cache in Macro](/macro-inc/macro/how-to-update-sqlx-query-cache-in-macro)

Learn how to update the SQLx query cache in macro. Simply run just prepare_db after modifying SQL queries or migrations to refresh compile-time metadata.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Format and Lint Rust Code in the Macro Repository](/macro-inc/macro/how-to-format-and-lint-rust-code-in-macro)

Learn to format and lint Rust code in the macro repository using just check. This command streamlines cargo fmt and cargo clippy checks for changed files.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Run Tests for a Specific Crate in Macro: A Complete Guide](/macro-inc/macro/how-to-run-tests-for-specific-crate-in-macro)

Learn how to run tests for a specific crate in Macro with our complete guide. Discover the simple `cargo test -p <crate-name>` command to streamline your development workflow.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Stop the Macro Local Stack: Complete Guide for Clean Shutdown](/macro-inc/macro/how-to-stop-macro-local-stack)

Easily stop the macro local stack by pressing q in the terminal or running just stack down. This guide provides a complete walkthrough for a clean shutdown.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Rebuild and Reload Rust Services in Macro: Fast Development Workflow](/macro-inc/macro/how-to-rebuild-and-reload-rust-services-in-macro)

Learn how to rebuild and reload Rust services instantly in Macro. This fast development workflow rebuilds only changed crates and reloads services without stopping the entire stack.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Seed Sample Data in a Macro Local Stack: Complete CLI Guide](/macro-inc/macro/how-to-seed-sample-data-in-macro-local-stack)

Learn to seed sample data in your Macro local stack using the Seed CLI for consistent permission testing and UI prototyping. Access deterministic data with just seed scenario commands.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Run Macro Locally with Stubbed Secrets: Complete Setup Guide](/macro-inc/macro/how-to-run-macro-locally-with-stubbed-secrets)

Run Macro locally with stubbed secrets using the no-doppler flag for immediate development. Get started fast without needing external API keys.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Start the Local Macro Stack: Complete Docker Compose Guide](/macro-inc/macro/how-to-start-local-macro-stack)

Quickly start the local Macro stack with Docker Compose. This guide details launching essential services like Postgres, Redis, and LocalStack for your Rust backend development.

- Tags: how-to-guide
- Published: 2026-08-21

### [Prerequisites for Developing Macro: Complete Development Environment Setup](/macro-inc/macro/what-are-prerequisites-for-developing-macro)

Set up your Macro development environment. Learn the essential prerequisites including Docker, Rust, Node.js, Just, PostgreSQL, Redis, and OpenSearch for efficient local development.

- Tags: getting-started
- Published: 2026-08-21

### [How to Set Up the Macro Development Environment: A Complete Guide](/macro-inc/macro/how-to-set-up-development-environment-for-macro)

Set up your macro development environment effortlessly. Clone macro-inc/macro, run nix develop, and start local services with just run_local. Your complete guide.

- Tags: how-to-guide
- Published: 2026-08-21

### [How Macro's Channel-Based Permission System Enables Automatic Sharing](/macro-inc/macro/macro-channel-based-permission-system-automatic-sharing)

Discover how Macro's channel-based permission system automatically shares objects. All channel members inherit access instantly, simplifying collaboration.

- Tags: internals
- Published: 2026-08-20

### [How to Implement a New AWS Lambda Handler for Asynchronous Processing in Macro](/macro-inc/macro/implement-new-lambda-handler-async-processing)

Learn to implement a new AWS Lambda handler for asynchronous processing. Define schemas, bundle arguments, set IAM policies, and connect SQS triggers for efficient event handling.

- Tags: how-to-guide
- Published: 2026-08-20

### [How to Configure Docker Services and Local Development Stack with `just` in Macro](/macro-inc/macro/configure-docker-services-local-dev-stack-just)

Configure Docker services and local development stack with the just command. Use just run_local for the full Macro environment or just stack up for Docker services.

- Tags: how-to-guide
- Published: 2026-08-20

### [How the Macro Connection Gateway Manages Massive WebSocket Connections Through Batching and Auto-Scaling](/macro-inc/macro/macro-connection-gateway-websocket-management-scale)

Discover how the Macro Connection Gateway handles thousands of WebSocket connections with efficient message batching and auto-scaling AWS Fargate containers for minimal overhead.

- Tags: architecture
- Published: 2026-08-20

### [SolidJS and TanStack Query Workflow for New Frontend Features in Macro](/macro-inc/macro/workflow-new-frontend-feature-solidjs-tanstack-query)

Learn Macro's 10-step SolidJS and TanStack Query workflow for building new frontend features efficiently. From setup to CI validated PRs, accelerate your development.

- Tags: how-to-guide
- Published: 2026-08-20

### [How Macro Delivers Real‑Time Notifications via WebSocket: Notification Service Architecture Explained](/macro-inc/macro/macro-notification-service-websocket-delivery)

Discover how Macro delivers real-time notifications using Kafka and WebSockets. Learn about the notification service architecture and its efficient message batching via HTTP API to the Connection Gateway.

- Tags: architecture
- Published: 2026-08-20

### [How to Use the Seed CLI to Generate Realistic Team Permission Test Scenarios](/macro-inc/macro/use-seed-cli-generate-test-scenarios-team-permissions)

Learn how to use the Seed CLI to generate realistic team permission test scenarios. Populate your Macro instance with production-like access patterns and reproducible test data.

- Tags: how-to-guide
- Published: 2026-08-20

### [How to Execute Tests Against a Local Postgres Database Without SQLX_OFFLINE in the Macro Repository](/macro-inc/macro/run-tests-local-postgres-without-sqlx-offline)

Execute tests against a local Postgres database without SQLX_OFFLINE. Spin up Docker Postgres with just setup_test_envs and just initialize_dbs, then run cargo test.

- Tags: how-to-guide
- Published: 2026-08-20

### [How Macro’s Email Service Handles Multi-Account Gmail Integration and Unified Inboxes](/macro-inc/macro/macro-email-service-gmail-integration-unified-inboxes)

Macro’s email service seamlessly integrates unlimited Gmail accounts into one unified inbox using per-account identifiers, cached OAuth tokens, and an aggregated search layer.

- Tags: architecture
- Published: 2026-08-20

### [How Macro's Model Context Protocol (MCP) Facilitates Interaction with External AI Agents](/macro-inc/macro/macro-mcp-integration-external-ai-agents)

Discover how Macro's Model Context Protocol (MCP) enables seamless interaction with external AI agents. Explore its standardized authentication, tool mapping, and dynamic prompt generation capabilities.

- Tags: deep-dive
- Published: 2026-08-20

### [How to Add a SQLx Database Migration and Update the `.sqlx` Cache Using the `prepare_db` Workflow](/macro-inc/macro/add-database-migration-sqlx-prepare-db-workflow)

Easily add new SQLx database migrations and update the compile-time cache with the prepare_db workflow. Learn how to run `cargo sqlx migrate add` and `just prepare_db`.

- Tags: how-to-guide
- Published: 2026-08-20

### [How the Docs Module Implements Real-Time Collaboration with Loro CRDTs and their‑mirror](/macro-inc/macro/macro-docs-crdt-realtime-collaboration-their-mirror)

Explore Macro Docs real-time collaboration powered by Loro CRDTs and their-mirror. Learn how conflict-free editing is achieved through efficient sync services.

- Tags: internals
- Published: 2026-08-20

### [How to Implement a New Hexagonal Architecture Rust Service in the Macro Monorepo](/macro-inc/macro/implement-rust-service-hexagonal-architecture-macro)

Learn to implement a Rust service using hexagonal architecture in Macro. Structure your code into domain, inbound, and outbound layers, then integrate with Axum's State pattern in main.rs.

- Tags: how-to-guide
- Published: 2026-08-20

### [How Macro's Bidirectional @linking System Functions Across Diverse Entity Types](/macro-inc/macro/macro-bidirectional-linking-entity-types)

Discover how Macro's bidirectional @linking system connects messages documents projects email threads and more using a central EntityMention struct for seamless cross-entity relationships.

- Tags: internals
- Published: 2026-08-20

### [How to Access Community Support for Macro Inc.: Github Issues, Discussions, and More](/macro-inc/macro/how-to-access-community-support-for-macro-inc)

Get Macro Inc. community support via GitHub Issues for bugs, Discussions for questions, and real-time chat on Slack or Discord. Find answers and contribute to the project.

- Tags: how-to-guide
- Published: 2026-08-20

### [Macro Inc. Example Projects: A Complete Guide to the Official SDK and Rust Samples](/macro-inc/macro/are-there-any-example-projects-using-macro-inc)

Explore Macro Inc. example projects in TypeScript and Rust. Discover webhook handling, message streaming, push notifications, and service integrations with the official SDK and samples.

- Tags: getting-started
- Published: 2026-08-20

### [Macro Inc. Troubleshooting: Common Issues and Fixes for the Macro Platform](/macro-inc/macro/what-are-common-troubleshooting-steps-for-macro-inc)

Troubleshoot Macro Inc. issues by verifying Doppler configuration, applying database migrations, enabling debug logging, and resetting your local stack for seamless service syncing.

- Tags: how-to-guide
- Published: 2026-08-20

### [How to Deploy Macro Inc. to a Production Environment: Complete 7-Step Guide](/macro-inc/macro/how-to-deploy-macro-inc-to-production-environment)

Deploy Macro Inc. to production in 7 steps. Build Rust, provision AWS, deploy Cloudflare Workers, publish Docker images, and orchestrate with CI/CD. Your complete guide.

- Tags: how-to-guide
- Published: 2026-08-20

### [Macro Inc Performance Benchmarks: What the Source Code Reveals](/macro-inc/macro/what-are-performance-benchmarks-for-macro-inc)

Discover Macro Inc performance benchmarks directly from its Rust source code. Learn optimization strategies embedded within the Macro repository for enhanced insights.

- Tags: performance
- Published: 2026-08-20

### [How to Report Bugs or Issues in the Macro Repository: A Complete Guide](/macro-inc/macro/how-to-report-bugs-or-issues-in-macro-repository)

Learn how to report bugs in the macro repository efficiently. Follow our guide to create effective GitHub Issues with clear steps for a quick resolution.

- Tags: how-to-guide
- Published: 2026-08-20

### [Macro Inc. Development Roadmap: AI-Native Workspace Architecture and Microservices](/macro-inc/macro/what-is-roadmap-for-macro-inc-development)

Explore the Macro Inc. development roadmap detailing its AI-native workspace architecture and Rust microservices. Discover the future of unified productivity.

- Tags: architecture
- Published: 2026-08-20

### [How to Integrate Macro Inc. with Other Systems: A Complete Guide to MCP, OAuth, and Webhook APIs](/macro-inc/macro/how-to-integrate-macro-inc-with-other-systems)

Integrate Macro Inc. with other systems. Learn to use MCP, OAuth, and webhook APIs for seamless system connections in this comprehensive guide.

- Tags: how-to-guide
- Published: 2026-08-20

### [Security Considerations for Macro Inc.: Defense-in-Depth in Rust Microservices](/macro-inc/macro/what-are-security-considerations-for-macro-inc)

Macro Inc. secures Rust microservices with defense-in-depth. Learn about compile-time secret validation, JWT middleware, API keys, and logging on AWS.

- Tags: security
- Published: 2026-08-20

### [How Macro Inc. Handles Data Storage and Persistence: A Multi-Layer Architecture](/macro-inc/macro/how-does-macro-inc-handle-data-storage-or-persistence)

Explore Macro Inc's polyglot persistence architecture. Discover how PostgreSQL, S3, Redis, OpenSearch, and DynamoDB combine for robust data storage and management in the macro-inc/macro repository.

- Tags: architecture
- Published: 2026-08-20

### [Comprehensive Guide to Macro Inc API Endpoints and Interfaces](/macro-inc/macro/what-are-api-endpoints-or-interfaces-for-macro-inc)

Explore Macro Inc API endpoints and interfaces. Discover our Axum-based HTTP and WebSocket services, unified Swagger docs at /docs, and individual service ports. Get started today.

- Tags: api-reference
- Published: 2026-08-20

### [How to Configure Macro Inc. for a Specific Use Case: A Developer’s Guide](/macro-inc/macro/how-to-configure-macro-inc-for-specific-use-case)

Learn how to configure Macro Inc. for your specific use case. This developer's guide covers environment variables, Docker services, and block-specific settings for the macro-inc/macro repository.

- Tags: how-to-guide
- Published: 2026-08-20

### [Core Features of the Macro Project: A Unified Workspace Built on Graph Architecture](/macro-inc/macro/what-are-core-features-of-macro-project)

Explore Macro's core features: an all-in-one workspace unifying email chat docs tasks AI agents calls storage PRs & CRM. Built on a bidirectional graph for seamless content linking.

- Tags: deep-dive
- Published: 2026-08-20

### [How to Install Macro Inc. Locally: A Complete Setup Guide for This Rust Micro-Service Workspace](/macro-inc/macro/how-to-install-macro-inc-locally)

Install Macro Inc. locally by cloning the repo and entering the Nix shell. Easily run the full Docker-based stack on your machine with a simple command. Get started today!

- Tags: how-to-guide
- Published: 2026-08-20

### [Where to Find Documentation for Macro Inc. (Complete Guide for 2024)](/macro-inc/macro/where-can-i-find-documentation-for-macro-inc)

Find Macro Inc documentation easily. Explore the public docs site, GitHub repo, API references, READMEs, and service guides for Macro Inc.

- Tags: getting-started
- Published: 2026-08-20

### [Macro Inc. License: AGPL-v3 Explained with Commercial Options](/macro-inc/macro/what-is-license-for-macro-inc-project)

Understand the AGPL-v3 license for Macro Inc. project. Learn about source code disclosure for SaaS and explore available commercial licensing options.

- Tags: licensing-guide
- Published: 2026-08-20

### [How to Run Tests in the Macro Repository: A Complete Guide](/macro-inc/macro/how-to-run-tests-in-macro-repository)

Learn how to run tests in the macro repository. Follow our guide to prepare your database environment and execute tests efficiently using Nix and Docker.

- Tags: how-to-guide
- Published: 2026-08-20

### [Build Tools and Dependencies for Macro: A Complete Developer Guide](/macro-inc/macro/what-are-build-tools-and-dependencies-for-macro)

Explore macro build tools and dependencies including Nix, Cargo, Docker Compose, axum, and tokio. This guide details the microservices workspace setup for reproducible builds.

- Tags: how-to-guide
- Published: 2026-08-20

### [How to Contribute to the Macro Inc. Project: A Complete Developer Workflow](/macro-inc/macro/how-to-contribute-to-macro-inc-project)

Learn how to contribute to the Macro Inc project. Follow our developer workflow: create an issue, fork the repo, set up PostgreSQL, follow architecture rules, pass CI, and open a Pull Request.

- Tags: how-to-guide
- Published: 2026-08-20

### [Main Components of the Macro Inc. Project: A Complete Architecture Guide](/macro-inc/macro/what-are-main-components-of-macro-inc-project)

Explore the main components of the Macro Inc. project. This Rust microservice platform features seven core layers for efficient development and deployment. Learn about storage, processing, communication, and more.

- Tags: architecture
- Published: 2026-08-20

### [How the Macro Repository Is Structured: A Complete Guide to the Cargo Workspace Monorepo](/macro-inc/macro/how-is-macro-repository-structured)

Explore the macro repository structure a Cargo workspace monorepo. Discover how 80+ Rust crates microservices and apps are organized in crates services apps and tooling directories.

- Tags: architecture
- Published: 2026-08-20

### [What Programming Languages Are Used in the Macro Repository?](/macro-inc/macro/what-programming-languages-are-used-in-macro-repository)

Discover the programming languages powering the Macro monorepo. Primarily Rust and TypeScript/JavaScript, with Python, TOML, JSON, and Shell for auxiliary tasks.

- Tags: getting-started
- Published: 2026-08-20

### [How to Set Up the Macro Inc. Development Environment: A Complete Guide](/macro-inc/macro/how-to-set-up-macro-inc-development-environment)

Learn how to set up the Macro Inc. development environment with Docker, Nix, and Just. Bootstrap your Rust microservices and connect to PostgreSQL, Redis, and OpenSearch.

- Tags: getting-started
- Published: 2026-08-20

### [What Is Macro Inc and What Does the macro Repository Do? Architecture, Services, and Code Examples](/macro-inc/macro/what-is-macro-inc-and-what-does-macro-repository-do)

Discover Macro Inc. and the macro repository. Learn about its Rust-centric microservice architecture for real-time collaboration. Explore services and code examples.

- Tags: architecture
- Published: 2026-08-20

### [How Macro’s Calendar Outbox Handles Scheduling and Sending Calendar Invites](/macro-inc/macro/how-does-macro-s-calendar-outbox-handle-scheduling-and-sending-calendar-invites)

Learn how Macro's calendar outbox schedules and sends invites using a durable pipeline with row-level locking and batch processing for at-least-once delivery.

- Tags: how-to-guide
- Published: 2026-08-18

### [Image Optimizer Service S3 Integration in Macro: CloudFront Lambda Origin Pattern](/macro-inc/macro/how-is-image-optimizer-service-implemented-with-s3-integration-in-macro)

Discover how Macro integrates S3 with CloudFront Lambda for on-the-fly image optimization. Learn about the origin group pattern and automatic caching of transformed images.

- Tags: internals
- Published: 2026-08-18

### [How Macro's Contact Service Manages Relationships Between Users](/macro-inc/macro/how-does-macro-s-contact-service-manage-relationships-between-users)

Discover how Macro's contact service manages user relationships using an event-driven architecture and an async SQS pipeline for scalable, consistent data.

- Tags: internals
- Published: 2026-08-18

### [How Webhooks Notify External Systems of Events in Macro: A Complete Technical Guide](/macro-inc/macro/how-do-webhooks-notify-external-systems-of-events-in-macro)

Learn how Macro webhooks notify external systems of events. Discover the asynchronous pipeline, SQS queuing, and HMAC-SHA256 signed payload delivery.

- Tags: how-to-guide
- Published: 2026-08-18

### [Macro Properties System Architecture: How Custom Fields Work on Entities](/macro-inc/macro/what-is-architecture-of-macro-s-properties-system-for-custom-fields-on-entities)

Explore Macro's properties system architecture. Discover how custom fields leverage a three-layer PostgreSQL database and Rust crate for seamless entity integration.

- Tags: architecture
- Published: 2026-08-18

### [How Macro's Sync Service Propagates Real-Time Updates Across Clients](/macro-inc/macro/how-does-macro-s-sync-service-propagate-real-time-updates-across-clients)

Discover how Macro's sync service achieves real-time updates using Cloudflare Durable Objects and the Loro framework for lightning-fast CRDT propagation.

- Tags: internals
- Published: 2026-08-18

### [JWT Authentication in Macro: Implementing Narrow-Scoped Document Permission Tokens](/macro-inc/macro/how-is-jwt-authentication-implemented-in-macro-with-narrow-scoped-tokens)

Explore JWT authentication in Macro. Discover how narrow-scoped document permission tokens are minted and validated using a dual-crate architecture for enhanced security.

- Tags: how-to-guide
- Published: 2026-08-18

### [How Macro's GraphQL APIs Expose Data to the Frontend with Proper Caching](/macro-inc/macro/how-do-macro-s-graphql-apis-expose-data-to-frontend-with-proper-caching)

Learn how Macro's GraphQL APIs expose data to the frontend with efficient caching. Discover how request-scoped DataLoaders and Solid-Query/URQL caching eliminate redundant requests.

- Tags: how-to-guide
- Published: 2026-08-18

### [How Macro Uses AWS Lambda Handlers for Async Processing: Docx Unzip & Email Suppression](/macro-inc/macro/how-are-lambda-handlers-used-for-async-processing-in-macro)

Discover how Macro leverages AWS Lambda handlers for efficient async processing of docx unzipping and email suppression. Learn about VPC networking, typed env variables, and IAM policies.

- Tags: how-to-guide
- Published: 2026-08-18

### [How Macro's Document Text Extractor Processes PDF and DOCX Files](/macro-inc/macro/how-does-macro-s-document-text-extractor-process-different-file-formats)

Learn how Macro's Rust-based text extractor processes PDF and DOCX files using pdfium-render and XML parsing for efficient text extraction from documents.

- Tags: how-to-guide
- Published: 2026-08-18

### [How Macro Implements CRM Functionality with Custom Properties on Contacts and Companies](/macro-inc/macro/how-is-crm-functionality-implemented-in-macro-with-custom-properties-on-contacts-companies)

Learn how Macro implements CRM functionality using custom properties on contacts and companies. Extend entities with user-defined schema and keep core tables clean.

- Tags: internals
- Published: 2026-08-18

### [How Macro Creates Tasks from Emails with Bidirectional Linking](/macro-inc/macro/how-are-tasks-created-from-emails-with-bidirectional-linking-to-source-in-macro)

Learn how Macro automatically creates tasks from emails using bidirectional linking to connect tasks and source messages. Effortlessly manage your workflow.

- Tags: how-to-guide
- Published: 2026-08-18

### [How Macro's Notification Service Delivers and Manages Push and Email Notifications](/macro-inc/macro/how-are-notifications-delivered-and-managed-in-macro-s-notification-service)

Discover how Macro's notification service manages push and email delivery with its Axum-based microservice architecture and polling system, respecting user preferences.

- Tags: internals
- Published: 2026-08-18

### [How Macro's Connection Gateway Manages WebSocket Connections at Scale](/macro-inc/macro/how-does-macro-s-connection-gateway-manage-websocket-connections-at-scale)

Discover how Macro's connection gateway scales WebSocket connections horizontally using AWS Fargate and ALB target tracking for efficient real-time message routing.

- Tags: internals
- Published: 2026-08-18

### [How to Set Up SQLx Compile-Time Query Validation with `just prepare_db` in Macro](/macro-inc/macro/how-to-set-up-sqlx-compile-time-query-validation-with-just-prepare-db-in-macro)

Learn how to set up SQLx compile-time query validation with just prepare_db in Macro. Ensure your SQL queries are valid against your PostgreSQL schema before compilation.

- Tags: how-to-guide
- Published: 2026-08-18

### [How Macro's Document Storage Service Handles S3 Uploads and Retrieval](/macro-inc/macro/how-does-macro-s-document-storage-service-handle-s3-uploads-and-retrieval)

Discover how Macro's document storage service simplifies S3 uploads and retrieval with a testable S3Client wrapper enabling direct uploads, presigned URLs, and batch operations.

- Tags: how-to-guide
- Published: 2026-08-18

### [How Macro's Search Service is Implemented Using OpenSearch and Event-Driven Processing](/macro-inc/macro/how-is-macro-s-search-service-implemented-using-opensearch-and-search-processing)

Discover how Macro implements its search service using OpenSearch and event-driven processing. Learn about its two cooperating Rust services for efficient search and indexing.

- Tags: architecture
- Published: 2026-08-18

### [Understanding Channel-Based Permissions in Macro's Messaging System](/macro-inc/macro/what-are-channel-based-permissions-in-macro-s-messaging-system)

Learn about Macro's channel based permissions. Understand how SharePermission and ChannelSharePermission grant granular read, write, and admin access to resources within channels.

- Tags: how-to-guide
- Published: 2026-08-18

### [How Macro's Email Service Integrates with Gmail Using OAuth and the Google API](/macro-inc/macro/how-is-macro-s-email-service-integrated-with-gmail-using-oauth-and-google-api)

Learn how Macro's email service integrates with Gmail using OAuth and Google API for secure, sustained access and real-time mailbox updates. Discover the technical details.

- Tags: integration-guide
- Published: 2026-08-18

### [How Macro Implements a Unified Inbox to Aggregate Emails, Messages, and Tasks](/macro-inc/macro/how-is-unified-inbox-implemented-in-macro-to-aggregate-emails-messages-mentions-and-tasks)

Discover how Macro's unified inbox aggregates emails messages and tasks into a single chronological feed using a logical database view and SQL query for seamless access.

- Tags: how-to-guide
- Published: 2026-08-18

### [How Macro AI Agents Access Team Memory and Use MCP Tools](/macro-inc/macro/how-do-macro-s-ai-agents-access-team-memory-and-what-mcp-tools-are-available)

Discover how Macro AI agents access team memory via PostgreSQL and utilize MCP tools like ReadTeamMemory and WriteTeamMemory through a Streamable HTTP transport. Learn about Macro's architecture.

- Tags: how-to-guide
- Published: 2026-08-18

### [How Macro Implements CRDT-Based Real-Time Collaboration for Docs](/macro-inc/macro/what-is-crdt-based-real-time-collaboration-implementation-for-macro-s-docs-feature)

Discover how Macro implements CRDT-based real-time collaboration for docs using loro-crdt. Experience seamless distributed editing with automatic conflict resolution.

- Tags: internals
- Published: 2026-08-18

### [How Macro's Bidirectional @linking System Connects Docs, Messages, Tasks, and Emails](/macro-inc/macro/how-does-macro-s-bidirectional-linking-system-connect-docs-messages-tasks-and-emails)

Discover how Macro's bidirectional @linking system seamlessly connects docs messages tasks and emails using XML tags and JSON payloads for efficient cross-referencing.

- Tags: deep-dive
- Published: 2026-08-18

### [How Macro's Rust Backend Implements the Hexagonal Architecture Pattern](/macro-inc/macro/how-does-macro-s-rust-backend-implement-hexagonal-architecture-pattern)

Discover how Macro's Rust backend implements hexagonal architecture. Isolate domain logic with traits and adapters for independent business rules. Explore the macro-inc/macro repository.

- Tags: architecture
- Published: 2026-08-18

### [How the Macro Conversion Service Handles Different Document Formats](/macro-inc/macro/conversion-service-document-format-handling)

Discover how the Macro conversion service expertly handles diverse document formats. Learn about file extension detection, LibreOffice filter selection, and secure sandboxed conversions.

- Tags: how-to-guide
- Published: 2026-08-18

### [Static File Service and CDN Integration in the Macro Platform](/macro-inc/macro/static-file-service-cdn-integration)

Discover the Macro static file service and its CDN integration. Learn how it uses Amazon S3, CloudFront, and Lambda for global asset distribution and on-the-fly image optimization.

- Tags: how-to-guide
- Published: 2026-08-18

### [How the Email Suppression Handler Works and Manages Gmail Attachments in Macro](/macro-inc/macro/email-suppression-handler-gmail-attachment-management)

Discover how the email suppression handler manages Gmail attachments. This AWS Lambda function processes bounce notifications and fetches attachments on-demand directly from the Gmail API.

- Tags: deep-dive
- Published: 2026-08-18

### [AI Processing Pipeline for the Document Cognition Service: A Technical Deep Dive](/macro-inc/macro/document-cognition-service-ai-processing-pipeline)

Explore the AI processing pipeline for the Document Cognition Service. This deep dive details the nine-stage Rust pipeline, Axum routing, LLM integration, and structured response generation.

- Tags: deep-dive
- Published: 2026-08-17

### [How Rate Limiting for External API Calls Works in the Macro Repository](/macro-inc/macro/rate-limiting-implementation-external-api-calls)

Learn how Macro implements rate limiting for external API calls using Redis, a sliding-window algorithm, and Lua scripts for efficient quota management. Understand cost-based consumption for services like Gmail.

- Tags: how-to-guide
- Published: 2026-08-17

### [Error Handling Patterns Using the `rootcause` Crate in the Macro Codebase](/macro-inc/macro/error-handling-patterns-rootcause-crate)

Learn robust error handling patterns in the Macro codebase using the rootcause crate. Wrap errors with context and stack traces for better diagnostics and stable public error codes.

- Tags: best-practices
- Published: 2026-08-17

### [How to Set Up Local Development with Docker Compose for Macro](/macro-inc/macro/docker-compose-local-development-setup-macro)

Easily set up local development for Macro a multi-service Rust app with Docker Compose. Start the entire stack including PostgreSQL Redis Kafka and more with simple commands.

- Tags: how-to-guide
- Published: 2026-08-17

### [How Background Jobs Are Processed Using SQS Workers in the Macro Repository](/macro-inc/macro/background-job-processing-sqs-workers)

Discover how Macro Inc's SQS workers process background jobs. Learn about concurrent message processing, automatic restarts, and graceful shutdown in macro-inc/macro.

- Tags: internals
- Published: 2026-08-17

### [How Macro Implements Contact and CRM Synchronization Across Email and Messages](/macro-inc/macro/contact-crm-synchronization-email-messages)

Learn how Macro implements contact and CRM synchronization across email and messages. Centralize contact records and sync email addresses with CRM entries for seamless data management.

- Tags: internals
- Published: 2026-08-17

### [How the Macro Authentication Service Handles JWT Tokens: Implementation Guide](/macro-inc/macro/authentication-service-jwt-token-handling)

Learn how the Macro authentication service handles JWT tokens. Discover implementation details using the macro_auth crate, AWS Secrets Manager, and Axum middleware for secure request validation.

- Tags: implementation-guide
- Published: 2026-08-17

### [Event-Driven Architecture of the Macro Notification Service: A 6-Stage Pipeline Deep Dive](/macro-inc/macro/notification-service-event-driven-architecture)

Explore the event-driven architecture of Macro's notification service. Discover its 6-stage pipeline, SQS queues, and Postgres LISTEN/NOTIFY for reliable, realtime communication at scale.

- Tags: deep-dive
- Published: 2026-08-17

### [How Macro Aggregates Team Memory from Multiple Data Sources](/macro-inc/macro/team-memory-aggregation-multiple-data-sources)

Discover how Macro aggregates team memory from diverse data sources like documents, projects, and calls. Our nightly process synthesizes activity into a unified memory store.

- Tags: how-to-guide
- Published: 2026-08-17

### [How Entity Access Control and Share Permission Management Work in Macro](/macro-inc/macro/entity-access-control-share-permission-management)

Discover how Macro Inc handles entity access control and share permission management using the SharePermission model for secure authorization.

- Tags: how-to-guide
- Published: 2026-08-17

### [How Macro Implements Channel-Based Permissions: Architecture and Code](/macro-inc/macro/channel-based-permissions-system-implementation-macro)

Discover how Macro implements channel-based permissions using a share-permission model and JWT tokens. Explore the architecture and code for secure access control.

- Tags: architecture
- Published: 2026-08-17

### [Database Migration Workflow in Macro Using SQLx and SQLX_OFFLINE Mode](/macro-inc/macro/database-migration-workflow-sqlx-sqlx_offline-mode)

Learn Macro's three-phase SQLx workflow for database migration. Apply migrations, update cache with sqlx prepare, and compile with SQLX_OFFLINE=true for zero build-time dependencies.

- Tags: how-to-guide
- Published: 2026-08-17

### [Hexagonal Architecture Patterns in Macro’s Rust Services: A Complete Guide](/macro-inc/macro/hexagonal-architecture-patterns-rust-services-macro)

Explore hexagonal architecture patterns in Macro's Rust services. Learn how three layers isolate business logic from I/O for robust, maintainable code.

- Tags: deep-dive
- Published: 2026-08-17

### [Document Text Extraction Pipeline for PDF and DOCX Processing in Macro](/macro-inc/macro/document-text-extraction-pipeline-pdf-docx-processing)

Discover Macro's document text extraction pipeline for PDFs and DOCX. Learn how it uses AWS services like pdfium-render and tiktoken-rs to convert files into searchable text with metadata.

- Tags: how-to-guide
- Published: 2026-08-17

### [OpenSearch Indexing Pipeline for the Search Processing Service: How Macro Indexes Documents](/macro-inc/macro/search-processing-service-opensearch-indexing-pipeline)

Explore Macro's OpenSearch indexing pipeline for search processing. Learn how it consumes Kafka events, enriches metadata, and upserts documents into OpenSearch with automatic rollback.

- Tags: how-to-guide
- Published: 2026-08-17

### [How the Macro Connection Gateway Handles WebSockets and Real-Time Messaging](/macro-inc/macro/connection-gateway-websocket-handling-real-time-messaging)

Discover how the Macro connection gateway uses WebSockets and Redis Pub/Sub for real-time messaging, powering live updates and notifications on the platform.

- Tags: internals
- Published: 2026-08-17

### [How the Gmail API Is Integrated for Unified Inbox and Email Service in Macro](/macro-inc/macro/email-service-gmail-api-integration-unified-inbox)

Learn how Macro integrates the Gmail API for a unified inbox. Discover its layered architecture for OAuth, JWT verification, and bidirectional sync with PostgreSQL.

- Tags: how-to-guide
- Published: 2026-08-17

### [Architecture of the Document Storage Service and Its S3 Integration Patterns: A Deep Dive into Macro's Implementation](/macro-inc/macro/document-storage-service-architecture-s3-integration-patterns)

Explore Macro's Document Storage Service architecture. Learn about S3 integration patterns, CloudFront signed URLs, and direct client uploads in this deep dive.

- Tags: architecture
- Published: 2026-08-17

### [How MCP Integration Enables Agent Actions in Macro: Protocol Architecture and Implementation](/macro-inc/macro/how-mcp-integration-enables-agent-actions-macro)

Discover how MCP integration unlocks agent actions in Macro. Explore the protocol architecture and implementation enabling external HTTP clients to leverage Macro's AI toolset.

- Tags: architecture
- Published: 2026-08-17

### [CRDT Collaboration Architecture in Macro: Loro and Cloudflare Durable Objects](/macro-inc/macro/macro-crdt-collaboration-architecture-loro-cloudflare-durable-objects)

Explore Macro's CRDT collaboration architecture using Loro and Cloudflare Durable Objects for strong consistency and automatic conflict resolution in real-time editing.

- Tags: architecture
- Published: 2026-08-17

### [How Macro Implements Bidirectional @linking Between Entities](/macro-inc/macro/how-macro-implements-bidirectional-linking-between-entities)

Discover how Macro implements bidirectional @linking using a directed-graph table and symmetric lookup helpers for efficient reverse traversal.

- Tags: internals
- Published: 2026-08-17

### [How the Document Cognition Service Analyzes and Processes Uploaded Documents in Macro](/macro-inc/macro/how-does-the-document-cognition-service-analyze-and-process-uploaded-documents-in-macro)

Discover how the Macro Document Cognition Service analyzes and processes uploaded documents through ingestion, text extraction, and AI-driven analysis for searchable, enhanced content.

- Tags: deep-dive
- Published: 2026-08-16

### [Macro Observability Stack: OpenTelemetry and Datadog Implementation Guide](/macro-inc/macro/what-is-the-observability-stack-used-in-macro-including-opentelemetry-and-datadog)

Discover Macro's observability stack using OpenTelemetry and Datadog. Achieve end-to-end visibility with automatic trace-log correlation for Rust applications.

- Tags: how-to-guide
- Published: 2026-08-16

### [How Macro's Notification Service Handles Push and In-App Notifications](/macro-inc/macro/how-does-the-notification-service-in-macro-handle-push-and-in-app-notifications)

Discover how Macro's notification service uses transport adapters for APNs push and WebSocket in-app notifications, powered by a unified domain model and event-driven architecture.

- Tags: internals
- Published: 2026-08-16

### [Macro's Testing Strategy: Local e2e, Integration, and Unit Test Architecture Explained](/macro-inc/macro/what-is-macros-testing-strategy-including-local-e2e-and-integration-tests)

Explore Macro's three-layer testing strategy: fast unit tests, cross-crate integration tests, and local e2e tests orchestrated with Docker Compose. Learn how Macro ensures code quality.

- Tags: testing
- Published: 2026-08-16

### [How Macro Manages Database Migrations Across Its SQLx Database Clients](/macro-inc/macro/how-are-database-migrations-managed-across-macros-different-sqlx-database-clients)

Learn how Macro Inc manages database migrations for its SQLx clients. Discover the centralized macro_db_client crate and shared macro_db_migrator library for efficient schema changes.

- Tags: how-to-guide
- Published: 2026-08-16

### [How the Macro Sync-Service Uses Cloudflare Workers for Real-Time Synchronization](/macro-inc/macro/how-does-the-sync-service-utilize-cloudflare-workers-for-real-time-synchronization)

Discover how the Macro sync-service leverages Cloudflare Workers for real-time synchronization. Explore its low-latency collaboration with WebSockets and CRDTs.

- Tags: how-to-guide
- Published: 2026-08-16

### [How Macro Implements Authentication and Authorization with FusionAuth](/macro-inc/macro/what-authentication-and-authorization-mechanisms-does-macro-use-with-fusionauth)

Discover how Macro implements authentication and authorization with FusionAuth using OAuth 2.0 JWT validation and role claims for robust security.

- Tags: how-to-guide
- Published: 2026-08-16

### [How Macro's Email Service Integrates with Gmail API and Synchronizes Emails: A Production-Grade Rust Implementation](/macro-inc/macro/how-does-the-email-service-in-macro-integrate-with-the-gmail-api-and-synchronize-emails)

Explore Macro's Rust implementation for bidirectional Gmail integration. Learn how the email service uses Pub/Sub, Redis auth, SQS, and cursor-based sync for production-grade email synchronization.

- Tags: how-to-guide
- Published: 2026-08-16

### [Macro Rust Service Deployment Patterns: CI-Driven Microservices with Nix, Crane, and Pulumi](/macro-inc/macro/what-are-the-deployment-patterns-for-macros-rust-services)

Discover Macro Rust service deployment patterns using Nix CI, Crane for Docker, cargo-zigbuild for Lambda, and Pulumi for infrastructure orchestration.

- Tags: best-practices
- Published: 2026-08-16

### [How Macro's Search Service Indexes Documents and Attachments Using OpenSearch: A Technical Deep Dive](/macro-inc/macro/how-does-macros-search-service-index-documents-and-attachments-using-opensearch)

Discover how Macro's search service indexes documents and attachments using OpenSearch. Learn about its three-stage pipeline from Kafka ingestion to dual-index writing for full searchability.

- Tags: deep-dive
- Published: 2026-08-16

### [How Macro Implements Event-Driven Architecture with SQS Queues and Lambda Triggers](/macro-inc/macro/what-is-the-event-driven-architecture-of-macro-using-sqs-queues-and-lambda-triggers)

Discover Macro's event-driven architecture using SQS queues and Lambda triggers. Learn how Macro implements durable buffering and lightweight event processing with Rust workers.

- Tags: architecture
- Published: 2026-08-16

### [How Macro’s CRM Automatically Aggregates Emails for Company and Contact Objects](/macro-inc/macro/how-does-macros-crm-automatically-aggregate-emails-for-company-and-contact-objects)

Discover how Macro CRM automatically aggregates emails for company and contact objects via a Pub/Sub pipeline, streamlining your communication tracking and providing essential interaction timestamps.

- Tags: how-to-guide
- Published: 2026-08-16

### [How Macro's Connection Gateway Handles WebSocket Connections at Scale](/macro-inc/macro/how-does-the-connection-gateway-in-macro-handle-websocket-connections-at-scale)

Discover how Macro's connection gateway scales to thousands of WebSocket connections using AWS Fargate and Application Load Balancer auto-scaling. Learn about target-tracking policies for efficient management.

- Tags: architecture
- Published: 2026-08-16

### [MacroDB, CommsDB, EmailDB, and ContactsDB Architecture Explained: 4-Database Design in the Macro Repository](/macro-inc/macro/what-is-the-database-architecture-involving-macrodb-commsdb-emaildb-and-contactsdb)

Explore the Macro Repository's 4-database design: MacroDB, CommsDB, EmailDB, and ContactsDB. Learn how this architecture isolates data in dedicated Rust crates for optimal performance.

- Tags: architecture
- Published: 2026-08-16

### [How Macro Creates Bidirectional Links When Generating Tasks from Emails or Messages](/macro-inc/macro/how-does-macro-create-bidirectional-links-when-generating-tasks-from-emails-or-messages)

Discover how Macro creates bidirectional links for tasks generated from emails or messages. Learn about its atomic row writing and queryable parent-child relationships.

- Tags: internals
- Published: 2026-08-16

### [How Macro's 42 Microservices Are Organized and How They Communicate: Architecture Deep Dive](/macro-inc/macro/how-are-macros-42-microservices-organized-and-how-do-they-communicate)

Discover how Macro organizes its 42 microservices in Rust crates and their communication methods including HTTP APIs SQS queues Redis PubSub and WebSockets.

- Tags: architecture
- Published: 2026-08-16

### [How Macro's Document Processing Pipeline Works: From Upload to Search Indexing](/macro-inc/macro/describe-the-document-processing-pipeline-in-macro-from-upload-to-search-indexing)

Discover Macro's document processing pipeline. Learn how binary data becomes searchable text through S3, Lambda workers, and OpenSearch indexing.

- Tags: internals
- Published: 2026-08-16

### [How Macro's MCP Server Exposes Tool Coverage for External AI Agents](/macro-inc/macro/how-does-macros-mcp-server-expose-tool-coverage-for-external-ai-agents)

Macro's MCP server exposes tool coverage via a Streamable HTTP binary. Discover available tools, capabilities, and URLs for external AI agents in this technical guide.

- Tags: how-to-guide
- Published: 2026-08-16

### [How Macro Implements Agent Memory for Synthesizing Email, Messages, Tasks, Docs, and Calls](/macro-inc/macro/how-does-macro-implement-its-agent-memory-system-for-synthesizing-information-across-various-communication-types)

Discover how Macro's agent memory synthesizes emails, messages, tasks, docs, and calls using a Rust architecture and PostgreSQL. Get unified knowledge snapshots refreshed daily.

- Tags: internals
- Published: 2026-08-16

### [How Macro's Channel-Based Permission System Works with @mentions: A Complete Technical Guide](/macro-inc/macro/what-are-the-mechanics-of-macros-channel-based-permission-system-with-mentions)

Explore Macro's channel based permission system and how @mentions grant access to documents and tasks. Understand the technical mechanics.

- Tags: deep-dive
- Published: 2026-08-16

### [Macro's Hexagonal Architecture Pattern in Rust Services: A Complete Technical Deep Dive](/macro-inc/macro/explain-the-hexagonal-architecture-pattern-used-in-macros-rust-services)

Explore Macro's Rust services and their hexagonal architecture. Learn about the domain, inbound, and outbound crates for clean, testable microservices.

- Tags: deep-dive
- Published: 2026-08-16

### [How Macro's Unified Inbox Aggregates Multiple Gmail Accounts: OAuth to Indexed Search](/macro-inc/macro/how-does-macros-unified-inbox-aggregate-multiple-gmail-accounts)

Learn how Macro unifies multiple Gmail accounts using OAuth and indexed search. Access all your messages in one chronological inbox for efficient email management.

- Tags: deep-dive
- Published: 2026-08-16

### [Macro's CRDT-Based Real-Time Collaboration Architecture: A Deep Dive into Loro-Powered Document Sync](/macro-inc/macro/what-is-the-architecture-of-macros-crdt-based-real-time-collaboration-in-docs)

Explore Macro's Loro-powered CRDT architecture for real-time document sync. Discover how WAL, anti-entropy, and pluggable transports ensure eventual consistency.

- Tags: deep-dive
- Published: 2026-08-16

### [How Macro’s Bidirectional @linking System Works Across Different Block Types](/macro-inc/macro/how-does-macros-bidirectional-linking-system-work-across-different-block-types)

Discover how Macro's bidirectional @linking system efficiently connects different block types using a unified entity_mentions table for seamless forward and reverse lookups.

- Tags: internals
- Published: 2026-08-16

### [Design Patterns in the macro-inc/macro Codebase: A Complete Architectural Guide](/macro-inc/macro/macro-inc-macro-design-patterns)

Explore design patterns in the macro-inc/macro codebase. Discover clean architecture, port-and-adapter, repository pattern, fluent builders, trait-based DI, and decorator middleware.

- Tags: architecture
- Published: 2026-08-15

### [The Versioning Strategy for macro-inc/macro Releases: Semantic Versioning in a Mono-Repo](/macro-inc/macro/macro-inc-macro-versioning-strategy)

Discover macro-inc/macro's semantic versioning strategy. Learn how unified versions, Git tags, and GitHub Actions streamline releases in this mono-repo.

- Tags: best-practices
- Published: 2026-08-15

### [How to Set Up a Development Environment for macro-inc/macro: Complete Guide](/macro-inc/macro/how-to-set-up-macro-inc-macro-development-environment)

Easily set up a development environment for macro-inc/macro. Follow this guide to install Nix Docker clone the repo run nix develop and start the full stack with just run_local.

- Tags: getting-started
- Published: 2026-08-15

### [macro-inc/macro Contributing Guidelines: A Complete Guide to Quality Contributions](/macro-inc/macro/macro-inc-macro-contributing-guidelines)

Learn the macro-inc/macro contributing guidelines. Follow our steps for quality contributions, including issue reporting, commit naming, code formatting, and licensing.

- Tags: how-to-guide
- Published: 2026-08-15

### [How the macro-inc/macro API is Designed and Structured: A Deep Dive into Axum-Based Microservices](/macro-inc/macro/macro-inc-macro-api-design-structure)

Explore the design and structure of the macro-inc/macro API. Learn how Axum-based microservices use typed router state and declarative routes for modularity.

- Tags: deep-dive
- Published: 2026-08-15

### [What Database Does Macro-Inc's Macro Use? A Complete Data Architecture Breakdown](/macro-inc/macro/macro-inc-macro-database-usage)

Discover the exact databases used by Macro-Inc's macro repository. Learn about its complete data architecture including PostgreSQL, DynamoDB, Redis, OpenSearch, and S3.

- Tags: architecture
- Published: 2026-08-15

### [External Libraries and Frameworks Powering the Macro Inc Repository](/macro-inc/macro/macro-inc-macro-external-libraries-frameworks)

Discover the external libraries and frameworks like axum, sqlx, AWS SDK, tokio, and tracing that power the macro-inc/macro Rust repository. Optimize your development.

- Tags: deep-dive
- Published: 2026-08-15

### [CI/CD Pipelines and Setup for macro-inc/macro: A Complete Guide](/macro-inc/macro/macro-inc-macro-ci-cd-pipelines)

Explore the CI/CD pipelines for macro-inc/macro. Discover how GitHub Actions, `just`, Nix, and Docker Compose streamline integration and deployment for efficient development.

- Tags: how-to-guide
- Published: 2026-08-15

### [How Macro-Inc/Macro Handles Logging: Structured Observability with Tracing](/macro-inc/macro/macro-inc-macro-logging-handling)

Discover how macro-inc/macro handles logging with structured observability and tracing. Learn about its configurable subscribers, environment-driven filtering, and OpenTelemetry integration.

- Tags: how-to-guide
- Published: 2026-08-15

### [Dockerfile and Containerization Strategy for macro-inc/macro: A Complete Guide](/macro-inc/macro/macro-inc-macro-dockerfile-containerization)

Discover the macro-inc/macro Dockerfile and containerization strategy. This guide details a multi-stage build, isolated compilation, and composite development containers for efficient development and deployment.

- Tags: how-to-guide
- Published: 2026-08-15

### [What Are the Main Components and Services of the Macro Application?](/macro-inc/macro/macro-inc-macro-main-components-services)

Explore the core components and services of the macro-inc/macro application. Discover its Rust microservices, crates, SDKs, and SolidJS front-end, all built with hexagonal architecture.

- Tags: architecture
- Published: 2026-08-15

### [How Code Is Organized into Modules and Packages in macro-inc/macro: A Complete Workspace Guide](/macro-inc/macro/macro-inc-macro-code-organization-modules-packages)

Discover how macro-inc/macro organizes its Rust code into modules and packages within its Cargo workspace. Learn about the structure of crates, services, and apps.

- Tags: how-to-guide
- Published: 2026-08-15

### [Licensing Information for the macro-inc/macro Project: AGPL-3.0 Explained](/macro-inc/macro/macro-inc-macro-licensing-information)

Discover the AGPL-3.0 license for the macro-inc/macro project. Understand source code distribution requirements for SaaS and public deployments.

- Tags: licensing-information
- Published: 2026-08-15

### [Macro Example Usage Scenarios and Demos: A Complete Guide](/macro-inc/macro/macro-inc-macro-example-usage-demos)

Explore macro-inc/macro with ready-to-run TypeScript SDK examples, interactive SolidJS demos, and Docker environments. Discover the platform's capabilities today.

- Tags: getting-started
- Published: 2026-08-15

### [Documentation in the macro-inc/macro Repository: A Complete Guide to Local Docs](/macro-inc/macro/macro-inc-macro-documentation-within-repo)

Explore the comprehensive documentation within the macro-inc/macro repository. Find guides on product overviews, developer onboarding, APIs, style guides, and infrastructure specs.

- Tags: documentation
- Published: 2026-08-15

### [How to Run the Macro Project Locally After Cloning macro-inc/macro](/macro-inc/macro/how-to-run-macro-inc-macro-locally)

Clone macro-inc/macro and run the project locally. Enter the Nix shell with nix develop and use just run_local to launch the full Docker stack with Postgres Redis Rust and SolidJS.

- Tags: how-to-guide
- Published: 2026-08-15

### [Does macro-inc/macro Have Unit Tests and Where Are They Located: Complete Guide](/macro-inc/macro/macro-inc-macro-unit-tests-location)

Discover if macro-inc/macro has unit tests and their exact locations. Find tests in respective crate directories and integration tests in crates/integration_tests.

- Tags: how-to-guide
- Published: 2026-08-15

### [What Is the Purpose of the src Directory in macro-inc/macro?](/macro-inc/macro/macro-inc-macro-src-directory-purpose)

Discover the purpose of the src directory in macro-inc/macro. Learn how it holds Rust source code and enables Cargo to compile project microservices effectively.

- Tags: internals
- Published: 2026-08-15

### [Configuration Files in the macro-inc/macro Repository: A Complete Guide](/macro-inc/macro/macro-inc-macro-configuration-files)

Explore the macro-inc/macro repository's 15+ configuration files. Learn how they manage build orchestration, Rust toolchain, code quality, and cloud-native deployments. Master your build process.

- Tags: how-to-guide
- Published: 2026-08-15

### [How Dependencies Are Managed in the macro-inc/macro Rust Project](/macro-inc/macro/macro-inc-macro-dependency-management)

Discover how the macro-inc/macro Rust project manages dependencies across 80 crates using a Cargo workspace, centralized versions, and xtask automation for efficient development.

- Tags: internals
- Published: 2026-08-15

### [Build System and Build Tools in macro-inc/macro: A Complete Guide](/macro-inc/macro/macro-inc-macro-build-system)

Discover the build system and build tools in macro-inc/macro. Learn how Just and Cargo orchestrate compilation, testing, and packaging for over 80 Rust crates in this comprehensive guide.

- Tags: how-to-guide
- Published: 2026-08-15

### [Main Directories and Their Purposes in the macro-inc/macro Repository](/macro-inc/macro/macro-inc-macro-directories-purpose)

Explore the macro-inc/macro repository's eight main directories. Understand the purpose of apps, crates, docker, infra, packages, docs, .github, and tooling in this mono-repo.

- Tags: how-to-guide
- Published: 2026-08-15

### [macro-inc/macro Project Structure: A Deep Dive into the Cargo Workspace Architecture](/macro-inc/macro/macro-inc-macro-project-structure)

Explore the macro-inc/macro project structure, a Cargo workspace with 80+ Rust crates. Discover how reusable libraries and microservices are organized and managed.

- Tags: deep-dive
- Published: 2026-08-15

### [What Is the Primary Programming Language of the macro-inc/macro Repository?](/macro-inc/macro/what-programming-language-macro-inc-macro)

Discover the primary programming language of the macro-inc/macro repository. Explore the Rust codebase, organized as a Cargo workspace with numerous internal crates and async services.

- Tags: faq
- Published: 2026-08-15

### [How Macro Handles Data Retention and Cleanup with SFS Deletion Handlers](/macro-inc/macro/how-does-the-system-handle-data-retention-and-cleanup-with-sfs-deletion-handlers)

Discover how Macro manages data retention and cleanup using SFS deletion handlers. Learn about its two-stage pipeline for efficient file deletion and database synchronization.

- Tags: internals
- Published: 2026-08-15

### [Best Practices for Testing Microservices with Local Databases in Rust](/macro-inc/macro/what-are-the-best-practices-for-testing-microservices-with-local-databases)

Discover best practices for testing microservices with local databases in Rust. Use Docker Compose and environment variables for efficient integration testing. Run tests with `just test` for speed and realism.

- Tags: best-practices
- Published: 2026-08-15

### [How Macro Delivers Webhooks for External Events: A Complete Async Pipeline](/macro-inc/macro/how-are-webhooks-delivered-for-external-events)

Discover how Macro delivers webhooks for external events using an async pipeline. Learn about event reception, SQS enqueuing, and background worker processing with Reqwest.

- Tags: deep-dive
- Published: 2026-08-15

### [How Macro Implements Connection Tracking with DynamoDB for Scalable WebSocket Management](/macro-inc/macro/what-is-the-connection-tracking-mechanism-with-dynamodb)

Discover how Macro implements connection tracking with DynamoDB for scalable WebSocket management. Learn about TTL-based cleanup and Global Secondary Indexes for durable, state-free connection tracking.

- Tags: how-to-guide
- Published: 2026-08-15

### [How the AI Agent System Integrates Team Memory and Tools in the Macro Codebase](/macro-inc/macro/how-does-the-ai-agent-system-interact-with-team-memory-and-tools)

Discover how the Macro AI agent system integrates team memory and tools for context-aware automation. Explore dynamic tool registration and PostgreSQL-persisted memory.

- Tags: internals
- Published: 2026-08-15

### [Task Creation from Email or Chat Messages in Macro: The Complete Workflow](/macro-inc/macro/what-is-the-workflow-for-task-creation-from-email-or-chat-messages)

Learn how Macro converts emails and chat messages into structured tasks via parsing, action persistence, dispatch, and storage. Master the complete task creation workflow.

- Tags: how-to-guide
- Published: 2026-08-15

### [How Permissions and Share Permissions Are Managed in the Macro Codebase](/macro-inc/macro/how-are-permissions-and-share-permissions-managed-in-the-system)

Discover how Macro manages permissions and share permissions using the SharePermissionV2 model, offering link defaults and per-channel overrides for fine-grained control.

- Tags: internals
- Published: 2026-08-15

### [Document Text Extraction Flow for Different File Formats in the Macro Repository](/macro-inc/macro/what-is-the-document-text-extraction-flow-for-different-file-formats)

Discover the document text extraction flow at Macro. Learn how the platform ingests, converts, and extracts text from various file formats for searchable data and metadata.

- Tags: how-to-guide
- Published: 2026-08-15

### [How API Rate Limits and Throttling Are Handled Across Macro Services](/macro-inc/macro/how-are-api-rate-limits-and-throttling-handled-across-services)

Discover how Macro handles API rate limits and throttling across its services. Learn about the Redis-backed atomic sliding-window algorithm and Lua scripts for consistent enforcement.

- Tags: best-practices
- Published: 2026-08-15

### [Hexagonal Architecture Patterns in Macro's Rust Services: A Complete Implementation Guide](/macro-inc/macro/what-are-the-patterns-for-implementing-hexagonal-architecture-in-the-rust-services)

Master hexagonal architecture in Rust services. Learn Macro's pattern for domain-centric ports, adapter implementations, and dependency wiring for robust applications.

- Tags: how-to-guide
- Published: 2026-08-15

### [How Redis Caching Strategies Work for Session Management in Macro](/macro-inc/macro/how-do-redis-caching-strategies-work-for-session-management)

Discover how Macro uses Redis caching strategies for efficient session management. Learn about sub-millisecond access to transient data and automatic expiration for enhanced performance.

- Tags: deep-dive
- Published: 2026-08-15

### [How Macro's Contact Management System Works and Syncs with CRM Data](/macro-inc/macro/what-is-the-contact-management-system-and-how-does-it-sync-with-crm-data)

Discover Macro's contact management system. Learn how it centralizes contacts in a CRM database and syncs them via an SQS pipeline powered by the email service and teams crate.

- Tags: deep-dive
- Published: 2026-08-15

### [How the GraphQL API Layer Is Structured for the Web Client in Macro](/macro-inc/macro/how-is-the-graphql-api-layer-structured-for-the-web-client)

Discover how Macro structures its three-layer GraphQL API for the web client. Explore the async-GraphQL engine, shared schema, and Tauri client with SQLite cache.

- Tags: architecture
- Published: 2026-08-15

### [How the Macro Notification Service Delivers Real-Time User Notifications via WebSocket and Kafka](/macro-inc/macro/how-does-the-notification-service-deliver-real-time-user-notifications)

Discover how Macro's notification service uses WebSocket and Kafka to send real-time user alerts with sub-second latency. Learn about its scalable fan-out architecture.

- Tags: how-to-guide
- Published: 2026-08-15

### [Service-to-Service Communication Patterns in the Macro Repository: HTTP, SQS, and Lambda](/macro-inc/macro/what-patterns-are-used-for-service-to-service-communication-http-sqs-lambda)

Explore service-to-service communication patterns in the macro repository including synchronous HTTP APIs Axum asynchronous SQS and Lambda functions Learn how Macro Inc manages interservice communication efficiently

- Tags: architecture
- Published: 2026-08-14

### [How Macro Configures S3 Buckets for Document Storage with Lifecycle Policies](/macro-inc/macro/how-are-s3-buckets-configured-for-document-storage-with-lifecycle-policies)

Learn how Macro configures S3 buckets for document storage with lifecycle policies. Discover the automation of 30-day Glacier transitions and 90-day expirations.

- Tags: how-to-guide
- Published: 2026-08-14

### [How the Macro Email Service Handles Multi-Account Gmail Synchronization](/macro-inc/macro/how-does-the-email-service-handle-multi-account-gmail-synchronization)

Learn how the Macro email service synchronizes multiple Gmail accounts using OAuth, Google Watch, and Pub/Sub for real-time updates and efficient data fetching.

- Tags: internals
- Published: 2026-08-14

### [MacroDB Database Architecture and Migration Management in the Macro Platform](/macro-inc/macro/what-is-the-database-architecture-for-macrdb-and-how-are-migrations-managed)

Discover MacroDB's PostgreSQL database architecture and how SQLx and Just automate migrations for the Macro Platform. Learn efficient database management.

- Tags: architecture
- Published: 2026-08-14

### [How Lambda Triggers Power Async DOCX and PDF Processing in Macro](/macro-inc/macro/how-are-lambda-triggers-used-for-async-document-processing-docx-pdf)

Discover how Macro leverages Lambda triggers with S3 and SQS for efficient, asynchronous DOCX and PDF document processing, decoupling uploads from conversions.

- Tags: how-to-guide
- Published: 2026-08-14

### [How the Macro Search Service Integrates with OpenSearch for Full-Text Search](/macro-inc/macro/how-does-the-search-service-integrate-with-opensearch-for-full-text-search)

Discover how the Macro search service integrates with OpenSearch for efficient full-text search. Learn about its indexing, bulk updates, and query execution capabilities.

- Tags: how-to-guide
- Published: 2026-08-14

### [Architecture of the Macro WebSocket Gateway for Real-Time Communication](/macro-inc/macro/what-is-the-architecture-of-the-websocket-gateway-for-real-time-communication)

Explore the Macro WebSocket gateway architecture. Learn how the decoupled design separates connection management from event distribution for efficient real-time communication.

- Tags: architecture
- Published: 2026-08-14

### [How Macro Microservices Handle Authentication with JWT Tokens](/macro-inc/macro/how-is-authentication-handled-across-microservices-with-jwt-tokens)

Learn how Macro's microservices authenticate users with HS256-signed JWT tokens. Discover secure secret management with AWS Secrets Manager and streamlined authorization using MacroUserId.

- Tags: how-to-guide
- Published: 2026-08-14

### [How the Document Processing Pipeline Handles Uploads, Text Extraction, and Search Indexing in Macro](/macro-inc/macro/how-does-the-document-processing-pipeline-handle-uploads-text-extraction-and-search-indexing)

Explore the Macro document processing pipeline. Learn how uploads, text extraction, and search indexing work seamlessly via S3, queues, and asynchronous workers.

- Tags: internals
- Published: 2026-08-14

### [How the Entity Mentions System Implements a Bidirectional Graph in Macro](/macro-inc/macro/how-does-the-entity-mentions-system-work-in-the-bidirectional-graph)

Discover how the Macro entity mentions system uses a bidirectional graph with dual-keyed rows for O(log N) traversal. Learn about its efficient implementation.

- Tags: internals
- Published: 2026-08-14

### [Macro Release History Explained: How Versioning, CI, and Changelogs Work](/macro-inc/macro/what-is-the-release-history-of-macro)

Discover Macro's release history. Learn about its calendar versioning, CI-driven releases triggered by GitHub tags, and how changelogs are generated.

- Tags: release-history
- Published: 2026-08-14

### [Macro Community Forum: Where Users Get Support in 2024](/macro-inc/macro/is-there-a-community-forum-for-macro-users)

Find Macro community support in 2024 via GitHub Discussions, Issues, and Slack integrations. Get help directly from the macro-inc/macro team.

- Tags: community-engagement
- Published: 2026-08-14

### [How to Debug Issues in Macro: A Complete Guide for Developers](/macro-inc/macro/how-to-debug-issues-with-macro)

Debug Macro issues effectively. Learn to enable RUST_LOG debug, use just commands, and inspect tracing spans to resolve errors in the Macro microservices platform.

- Tags: how-to-guide
- Published: 2026-08-14

### [Advanced Features of Macro: A Deep Dive into Its Microservices Architecture and Capabilities](/macro-inc/macro/what-are-the-advanced-features-of-macro)

Explore Macro's advanced features. Discover its cloud-native microservices architecture, AI cognition, real-time messaging, and serverless processing for scalable workspaces. Learn more about macro-inc/macro.

- Tags: deep-dive
- Published: 2026-08-14

### [How to Update Macro to the Latest Version: A Complete Step-by-Step Guide](/macro-inc/macro/how-to-update-macro-to-the-latest-version)

Update Macro to the latest version by syncing source code, SQLx cache, migrations, and Docker services. Follow this complete step-by-step guide.

- Tags: how-to-guide
- Published: 2026-08-14

### [Common Use Cases for Macro: How Teams Leverage This All‑In‑One Rust Workspace](/macro-inc/macro/what-are-the-common-use-cases-for-macro)

Discover common use cases for Macro, the all-in-one Rust workspace. Integrate email, chat, docs, CRM, and more to streamline team collaboration and boost productivity.

- Tags: use-cases
- Published: 2026-08-14

### [Macro CLI: Command-Line Interface Guide for the Macro Platform](/macro-inc/macro/what-is-the-command-line-interface-for-macro)

Explore the Macro CLI tool for streamlined dev, deploy, test, and run operations. This guide covers the `macro` binary and its subcommands for efficient development.

- Tags: how-to-guide
- Published: 2026-08-14

### [How to Set Up a Macro Development Environment: Complete Local Stack Guide](/macro-inc/macro/how-to-set-up-a-development-environment-for-macro)

Easily set up a Macro development environment locally. Install Nix and Docker, run nix develop, then just run_local to launch the full stack with Postgres, Redis, Kafka, and more.

- Tags: getting-started
- Published: 2026-08-14

### [Where to Find Examples of Macro Usage: Official Docs, SDKs, and In-Repo Code Samples](/macro-inc/macro/where-to-find-examples-of-macro-usage)

Discover Macro usage examples in official docs, Rust/TypeScript SDKs within the macro-inc/macro repo, and CLI samples for easy integration. Get started today!

- Tags: getting-started
- Published: 2026-08-14

### [How to Report a Bug in Macro: A Complete Guide to the Official Workflow](/macro-inc/macro/how-to-report-a-bug-in-macro)

Report bugs in Macro effectively using the official GitHub issue workflow. Learn the exact format for clear bug reporting and how to handle security vulnerabilities privately.

- Tags: how-to-guide
- Published: 2026-08-14

### [What Is the License for Macro? Understanding the AGPL-3.0 Terms](/macro-inc/macro/what-is-the-license-for-macro)

Understand the AGPL-3.0 license for Macro. Explore the terms governing Macro's use and distribution in our repository. Learn about your software freedom.

- Tags: license-information
- Published: 2026-08-14

### [How to Contribute to the Macro Project: A Step‑by‑Step Guide](/macro-inc/macro/how-to-contribute-to-the-macro-project)

Learn how to contribute to the Macro project with this step by step guide. Follow our simple process to submit your code and make an impact.

- Tags: how-to-guide
- Published: 2026-08-14

### [Macro Project Structure Explained: 7 Core Components of a Rust Microservices Workspace](/macro-inc/macro/what-are-the-main-components-of-the-macro-project-structure)

Explore the Macro Rust monorepo project structure. Discover 7 core components including apps, services, crates, packages, infrastructure, Docker, and tooling for efficient development.

- Tags: internals
- Published: 2026-08-14

### [Where Is the Macro Documentation Located? A Complete Guide to Finding the Source Files](/macro-inc/macro/where-is-the-macro-documentation-located)

Find the Macro documentation easily. Discover the location of source files within the macro-inc/macro repository, including apps/docs and README files.

- Tags: how-to-guide
- Published: 2026-08-14

### [How to Run Macro Commands: A Complete Guide to Development Workflows](/macro-inc/macro/how-to-run-macro-commands)

Learn how to run Macro commands easily using `just` and `xtask` for efficient development testing and deployment. Streamline your workflow today.

- Tags: how-to-guide
- Published: 2026-08-14

### [What Is the Primary Purpose of the Macro Repository? A Unified Workspace Explained](/macro-inc/macro/what-is-the-primary-purpose-of-the-macro-repository)

Discover the primary purpose of the Macro repository a unified workspace integrating email messaging documents tasks agents and CRM into one fast searchable interface.

- Tags: getting-started
- Published: 2026-08-14

### [How to Configure Macro for a Project: A Complete Setup Guide](/macro-inc/macro/how-to-configure-macro-for-a-project)

Learn how to configure Macro for your project using a single JSON file. Simplify your CI/CD setup and manage all services declaratively.

- Tags: how-to-guide
- Published: 2026-08-14

### [What Programming Languages Does Macro Support? Full List and Developer Guide](/macro-inc/macro/what-programming-languages-does-macro-support)

Discover the 17 programming languages Macro supports, including JavaScript, Python, Rust, Java, Swift, C, C++, and SQL. Enhance your development workflow with Macro's lexical-core editor.

- Tags: getting-started
- Published: 2026-08-14

### [What Are the Prerequisites for Using Macro? Complete Setup Guide for 2024](/macro-inc/macro/what-are-the-prerequisites-for-using-macro)

Discover the prerequisites for using Macro locally. Learn about Docker, Rust, Node.js, Just, Nix, and database requirements for a smooth setup in 2024.

- Tags: how-to-guide
- Published: 2026-08-14

### [How to Install Macro for macro-inc: Complete Local Setup Guide (Nix + Docker)](/macro-inc/macro/how-to-install-macro-for-macro-inc)

Install Macro for macro-inc locally fast. Clone the repo, enter Nix shell, and run just run_local to launch 40+ Rust microservices with Postgres, Redis, Kafka, and OpenSearch.

- Tags: how-to-guide
- Published: 2026-08-14

### [What Is Macro by Macro-Inc? A Deep Dive Into the Rust-Based Document Platform](/macro-inc/macro/what-is-macro-by-macro-inc)

Discover Macro by macro-inc, a Rust-based platform for cloud-native document management. Explore its crates for storage, search, and workflow automation.

- Tags: deep-dive
- Published: 2026-08-14