Momen Cursor Rules - Build Custom Frontends with Momen Backend-as-a-Service

# Momen Cursor Rules - Build Custom Frontends with Momen Backend-as-a-Service

> **Prebuilt Cursor rules for developing custom frontend applications powered by [Momen.app](https://momen.app) as a headless Backend-as-a-Service (BaaS)**

This repository contains a comprehensive set of **production-ready Cursor rules** that enable AI assistants (Claude, ChatGPT, etc.) to seamlessly integrate with Momen's powerful backend infrastructure. Use these rules to rapidly build full-stack applications with custom frontends while leveraging Momen's enterprise-grade PostgreSQL database, GraphQL API, actionflows, AI agents, and more.

## 🎯 What This Repository Provides

This repository contains **8 specialized rule files** in `.cursor/rules/` that teach AI assistants how to:

1. **Understand Momen's Architecture** - Backend structure, GraphQL endpoints, authentication
2. **Query & Mutate Database** - Auto-generated GraphQL schema from your data model
3. **Execute Backend Logic** - Actionflows for complex, multi-step operations
4. **Integrate Third-party APIs** - Use imported API definitions as backend relays
5. **Leverage AI Agents** - RAG, tool use, multi-modal I/O, structured JSON output
6. **Handle Payments** - Stripe integration for one-time and subscription billing
7. **Manage Binary Assets** - Image/file uploads and management
8. **Fetch Project Schema** - MCP server integration for real-time schema access

## 📦 Included Rule Files

```
.cursor/rules/
├── momen-backend-architecture.mdc      # Core architecture & GraphQL setup
├── momen-database-gql-api-rules.mdc    # Database CRUD operations
├── momen-actionflow-gql-api-rules.mdc  # Backend workflows & business logic
├── momen-tpa-gql-api-rules.mdc         # Third-party API integration
├── momen-ai-agent-gql-api-rules.mdc    # AI agent capabilities
├── momen-stripe-payment-rules.mdc      # Payment processing
└── momen-binary-asset-upload-rules.mdc # File management
```

## 🚀 Quick Start

### Prerequisites

- [Cursor Editor](https://cursor.sh/) or any AI assistant supporting Cursor rules
- A [Momen.app](https://momen.app) account and project
- Basic knowledge of GraphQL and TypeScript/JavaScript

### Step 1: Build Your Backend in Momen

Before using these rules, you need to create your backend infrastructure in Momen:

1. **Sign up** at [Momen.app](https://momen.app) and create a new project
2. **Design your database** - Create tables, define relationships, and set up your data model
3. **Build backend logic** - Create actionflows for complex business logic
4. **Configure integrations** - Set up Stripe payments, AI agents, third-party APIs as needed
5. **Note your credentials**:
   - Your Momen username (email)
   - Your Momen password
   - Your project's `exId` (found in project settings) or project name

> **Tip**: Momen's visual editor makes it easy to design your entire backend without code. Once ready, use these Cursor rules to build a custom frontend that connects to your Momen backend!

### Step 2: Clone This Repository

```bash
git clone https://github.com/privateJiangyaokai/momen-cursor-rules.git
cd momen-cursor-rules
```

### Step 3: Copy Rules to Your Project

Copy the entire `.cursor` directory into your project root:

```bash
cp -r .cursor /path/to/your/project/
```

### Step 4: Configure MCP Server

The MCP server allows AI to automatically fetch your project's latest schema. To configure in Cursor:

1. Open Cursor Settings (⌘ + , on macOS, Ctrl + , on Windows)
2. Search for "MCP" or navigate to **Features → Model Context Protocol**
3. Click **"Edit Config"** or **"Add MCP Server"**
4. Add the Momen MCP server configuration:

```json
{
  "mcpServers": {
    "momen": {
      "command": "npx",
      "args": [
        "-y",
        "momen-mcp@latest"
      ]
    }
  }
}
```

**Alternative**: You can also manually edit the MCP config file:
- **macOS**: `~/Library/Application Support/Cursor/User/globalStorage/mcp-config.json`
- **Windows**: `%APPDATA%\Cursor\User\globalStorage\mcp-config.json`

> **Note**: The MCP server integration enhances AI's ability to understand your Momen project schema but is optional. The core Cursor rules work without it.

### Step 5: Vibe the Frontend

Open your project in Cursor and provide AI with your Momen credentials to start building. Use prompts like:

**Initial Setup**:
```
My Momen project is:  my-ecommerce-app (or exId: abc123xyz)

Build an ecommerce website based on the Momen project's backend structure. 
Use username authentication. 

+ Other misc requirements
e.g. Use Stripe publishable key: pk_test_51RQRPTCO2XREqHNZr8Vz0T1CNciMnXCM4I2qxb3ZYOi4GTHtbPnW8OJxGM9GR9L67jEngDUoBTMWOdr9W2AzMoKa00AzoEc7qr
```

The AI will use your credentials to authenticate, fetch your project schema, and generate production-ready code that perfectly matches your Momen backend structure!

## 🏗️ What is Momen?

[Momen](https://momen.app) is a next-generation **full-stack no-code platform** with a powerful backend designed for headless use

... (truncated)