Cursor Experience Project

A curated collection of Cursor IDE configurations, rules, and developer experience enhancements.

👤 Mobile Team Lead

Name: Gurkan Fikret Gunak
GitHub: @gurkanfikretgunak
LinkedIn: gurkanfikretgunak

📋 About

This project contains custom rules, configurations, and best practices for enhancing the development experience in Cursor IDE. It serves as a personal repository for Cursor-specific settings and workflows.

🚀 Projects Built with Cursor

These projects were developed and built using Cursor IDE, showcasing the power of AI-assisted development:

MasterFabric Platform

Source: GitHub

A self-hosted, scalable Backend-as-a-Service (BaaS) platform built with NestJS microservices, providing Authentication, dynamic GraphQL APIs, and Real-time functionality for multi-tenant applications. Features include comprehensive health monitoring, hot reload for live development, and a modular microservices architecture.

Tech Stack: NestJS, GraphQL, TypeScript, PostgreSQL, Redis, Docker

OSMEA

Live: osmea.masterfabric.co | Source: GitHub

A Mobile E-commerce Architecture Framework designed for building scalable, customizable, and cross-platform e-commerce applications using Flutter. It integrates with platforms like Shopify and WooCommerce, emphasizing modularity and security.

Tech Stack: Flutter, Dart

MasterFabric Welcome

Live: welcome.masterfabric.co | Source: GitHub

An open-source developer onboarding and internal ops portal that consolidates developer onboarding, worklogs, event management, and support into one place. Features include GitHub-based authentication, dynamic onboarding checklists, worklog tracking, internal event management, integrated support ticket system, and company email verification (OTP).

Tech Stack: Next.js 15, React 19, TypeScript, Supabase, Tailwind CSS, Sentry

Developer Candidate

Live: developer-candicate.vercel.app | Source: GitHub

An open-source hiring platform that standardizes the hiring process by measuring technical and behavioral competencies. Features include standardized evaluation methodology, department-based technical criteria, a 4-step detailed assessment process, and data-driven hiring decisions.

Tech Stack: Modern web technologies

Share Your Note

Live: share-your-note.vercel.app | Source: GitHub

A real-time event participation platform where attendees can join events managed by hosts to share notes, images, and emotions in real-time. Features include QR code-based event joining, host dashboard for event management, and live interaction capabilities.

Tech Stack: Next.js, Supabase, TypeScript

Developer Manifesto

Live: manifesto.masterfabric.co | Source: GitHub

A minimalist Next.js website for publishing developer manifestos with clean typography, interactive 3D animations, and GitHub-based signature system. Features include Markdown-driven content, JetBrains Mono typography, interactive Three.js animations with mouse interactions, GitHub authentication, dynamic signature system with Supabase, public RESTful API, and SEO optimization.

Tech Stack: Next.js 15+, TypeScript, TailwindCSS, Three.js with React Three Fiber, Supabase, Gray Matter, Remark

PathBunny

Source: GitHub

A lightning-fast CLI tool for creating directory shortcuts in your terminal. Jump to any directory instantly with memorable shortcuts instead of typing long paths. Features include quick navigation with aliases, persistent shortcuts storage, cross-platform support (macOS/Linux), and easy installation via npm.

Tech Stack: TypeScript, Node.js, Shell Scripts

These projects demonstrate how Cursor IDE can accelerate development workflows and help create production-ready applications efficiently.

📁 Project Structure

cursor/
├── learn/                    # Learning resources and configurations
│   ├── mcp/                  # Model Context Protocol configurations
│   │   ├── flutter-mcp.json
│   │   ├── mcp-servers.md
│   │   └── README.md
│   ├── agent/                # Agent configurations
│   │   ├── flutter-agent.json
│   │   └── README.md
│   └── extensions/           # Extension guides
│       └── remote-ssh.md
├── rules/                    # Cursor IDE rules and configurations
│   ├── semantic-commits.md
│   ├── flutter-cursor-rules.md
│   ├── project-manager-rules.md
│   ├── product-manager-rules.md
│   ├── devops-engineer-rules.md
│   ├── qa-engineer-rules.md
│   ├── tech-lead-rules.md
│   └── ai-efficiency-rules.md
├── tools/                    # Development tools
│   └── cli/                  # Gurkan CLI tool (npx gurkan)
│       ├── bin/
│       │   └── gurkan.js
│       ├── package.json
│       ├── PUBLISH.md
│       └── README.md
├── service/                  # Auth microservice (Fastify)
│   ├── src/
│   │   ├── core/            # Base classes and abstractions
│   │   ├── interfaces/      # Contract definitions
│   │   ├── dtos/            # Data Transfer Objects
│   │   ├── types/           # TypeScript type definitions
│   │   ├── repositories/    # Data Access Layer (Singleton)
│   │   ├── services/        # Business Logic Layer (Singleton)
│   │   ├── routes/          # API Route handlers
│   │   ├── lib/             # Infrastructure & utilities
│   │   └── server.ts        # Fastify server setup
│   ├── package.json
│   ├── tsconfig.json
│   ├── ARCHITECTURE.md
│   └── README.md
├── web/                      # Next.js web application
│   ├── app/                  # Next.js app directory
│   │   ├── api/             # API routes
│   │   ├── error.tsx
│   │   ├── global-error.tsx
│   │   ├── globals.css
│   │   ├── layout.tsx
│   │   ├── page.tsx
│   │   ├── redirect/
│   │   ├── robots.ts
│   │   └── sitemap.ts
│   ├── components/           # React components
│   │   ├── BlurTransition.tsx
│   │   ├── Footer.tsx
│   │   ├── Header.tsx
│   │   ├── LinkInterceptor.tsx
│   │   ├── MarkdownRenderer.tsx
│   │   └── ServiceHealth.tsx
│   ├── ui/                   # shadcn/ui components
│   │   ├── button.tsx
│   │   ├── input.tsx
│   │   ├── card.tsx
│   │   ├── form.tsx
│   │   ├── dialog.tsx
│   │   ├── auth-form.tsx
│   │   ├── oauth-buttons.tsx
│   │   └── user-menu.tsx
│   ├── lib/                  # Utility libraries
│   │   ├── api.ts           # API client for auth service
│   │   ├── db.ts
│   │   ├── email.ts
│   │   ├── git.ts
│   │   └── utils.ts
│   ├── public/               # Static assets
│   │   └── images/
│   ├── package.json
│   ├── next.config.js
│   ├── tsconfig.json
│   ├── tailwind.config.ts
│   ├── components.json
│   ├── instrumentation.ts
│   ├── sentry.client.config.ts
│   ├── sentry.edge.config.ts
│   ├── sentry.server.config.ts
│   ├── SENTRY_SETUP.md
│   └── README.md
├── .cursorrules.example        # Cursor IDE rules file example (Flutter focused)
├── LICENSE                      # MIT License
└── README.md                    # Project documentation

🚀 Getting Started

Clone this repository
Explore the rules/ directory for Cursor IDE configurations
Customize the rules according to your development needs

🛠️ Tools

CLI Tool

A personal CLI tool that can be run via npx:

npx gurkan

This displays information about Gurkan Fikret Gunak including skills, contact information, and more.

Location: tools/cli/

Documentation:

README.md: CLI tool usage and documentation
PUBLISH.md: Publishing guide for npm package

Usage:

npx gurkan - Display full information
npx gurkan --skills - Show skills only
npx gurkan --contact - Show contact info
npx gurkan --repos - Show repositories (masterfabric, masterfabric-mobile)
npx gurkan --masterfabric - Show Masterfabric company info
npx gurkan --github - Open GitHub profile
npx gurkan --help - Show help

📚 Learning Resources

The learn/ directory contains learning resources and configurations:

MCP Configuration: Model Context Protocol configurations for Flutter developers
- mcp-servers.md: Comprehensive guide to MCP servers in Cursor IDE (based on official Cursor documentation)
- mcp-prompts-and-tips.md: Guide to effective MCP prompts and usage tips
- flutter-mcp.json: MCP server configuration for Flutter development tools
- README.md: MCP setup guide for Flutter developers
Agent Configuration: Agent configurations and settings for Cursor IDE
- flutter-agent.json: Flutter development agent configuration
Rule Guides: Guides for mastering Cursor rules
- mastering-cursor-rules.md: Management strategies and 20 tips/tricks for effective rules
Extension Guides: Guides for essential extensions
- remote-ssh.md: Guide to using Remote - SSH for remote development

📝 Rules Directory

The rules/ directory contains Cursor IDE-specific rules and configurations that help streamline your development workflow.

Available Rules

semantic-commits.md: Guidelines for writing semantic commit messages following conventional commit standards
flutter-cursor-rules.md: Comprehensive Cursor rules for Flutter senior engineers covering architecture, best practices, and code quality standards
project-manager-rules.md: Comprehensive Cursor rules for project managers covering planning, communication, risk management, agile methodologies, and leadership best practices
product-manager-rules.md: Comprehensive Cursor rules for product managers covering product strategy, requirements, prioritization, metrics, and stakeholder management
devops-engineer-rules.md: Comprehensive Cursor rules for DevOps engineers covering infrastructure as code, CI/CD, monitoring, security, and automation best practices
qa-engineer-rules.md: Comprehensive Cursor rules for QA engineers covering test planning, automation, bug reporting, quality metrics, and collaboration best practices
tech-lead-rules.md: Comprehensive Cursor rules for tech leads covering technical leadership, team management, architecture decisions, code reviews, and process improvement
ai-efficiency-rules.md: Comprehensive rules for efficient AI prompt usage and code execution, focusing on minimizing token consumption, direct code implementation over planning, and orchestrating time and process consumption efficiently

🌐 Web Application

The web/ directory contains a Next.js web application that displays this project's content:

Framework: Next.js 14+ with App Router
Styling: Custom CSS with mobile-first responsive design
Features:
- Pixel-style blur-to-clear page transitions
- Redirect page with 3-second countdown for external links
- Mobile-optimized responsive layout
- Markdown content rendering
- Splash screen animation with Matrix-style effects
- Error Tracking & Analytics: Integrated with Sentry for error monitoring and performance analytics

Location: web/

Monitoring: Error tracking and analytics powered by Sentry

🤝 Contributing

This is a personal project, but suggestions and improvements are welcome!

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Note: This project is designed to enhance the Cursor IDE development experience with custom rules and configurations.