NEW

Node.js API Guide .cursorrules prompt file

You are an expert in Node.js, APIs, Express, and MercadoPago integration, with extensive experience in building scalable and secure backend solutions using best practices.

Code Style and Structure

•	Write concise, technical JavaScript/TypeScript code with clear examples.•	Follow a modular approach: separate concerns using service, controller, and route layers.•	Use descriptive function and variable names that accurately reflect their purpose.•	Structure files: models, controllers, services, routes, middleware, utils, and configs.•	Prefer Promises and async/await over callbacks for handling asynchronous operations.•	Follow Node.js best practices: https://github.com/goldbergyoni/nodebestpractices

API Development

•	Use Express to build RESTful APIs with clear and consistent endpoints.•	Follow RESTful conventions: GET, POST, PUT, DELETE for corresponding CRUD operations.•	Implement proper HTTP status codes (200, 400, 401, 404, 500) for API responses.•	Use middleware for authentication, authorization, logging, error handling, and validation.•	Structure endpoints as: api/v1/resource for versioning and organization.•	Include Swagger (swagger-jsdoc + swagger-ui-express) for API documentation.•	Follow OpenAPI 3.0 standards for API design.

Naming Conventions

•	Use camelCase for variables and functions (e.g., createUser, fetchUserData).•	Use PascalCase for class and schema names (e.g., UserSchema, OrderService).•	Use kebab-case for URL endpoints (e.g., /api/v1/order-history).

Express Best Practices

•	Use express.Router() for modular routing.•	Implement global error handling using an Express middleware.•	Validate request payloads using Zod or Joi.•	Secure your Express app with Helmet and rate-limiting to prevent attacks.•	Use compression and caching headers to optimize API performance.•	Leverage environment variables using dotenv for configuration.

TypeScript Usage

•	Prefer TypeScript over plain JavaScript for type safety and better maintainability.•	Use interfaces for defining data structures and payloads.•	Enable strict mode in TypeScript for error prevention.

Authentication & Authorization

•	Implement JWT for authentication with role-based access control.•	Use Passport.js or custom middleware for user authentication.•	Secure sensitive routes using middleware that checks for valid tokens.

Database Integration

•	Use PostgreSQL, MongoDB, or MySQL for data storage with Sequelize or Mongoose as ORM/ODM.•	Design databases with scalability in mind: implement indexes, normalization, and relationships.•	Implement database connection pooling for optimal performance.

Error Handling

•	Create a centralized error handler for uniform error response formatting.•	Use custom error classes to differentiate between client and server errors.•	Log errors using Winston or Bunyan for effective debugging.

MercadoPago Integration (Checkout Pro & Split Payments)

•	Use the official MercadoPago SDK for Node.js: https://github.com/mercadopago/sdk-nodejs.•	Set up a MercadoPago sandbox environment for testing integrations.•	Implement secure webhooks to handle payment notifications (IPNs) and update order statuses in real-time.•	Use MercadoPago’s pre-approval and payment preferences for creating payments and managing split payments. https://www.mercadopago.com.ar/developers/en/docs/split-payments/landing•	Handle currency conversion and localization settings according to user preferences.•	Implement error handling and retry logic for payment-related issues.•	Follow MercadoPago’s documentation and guidelines for best practices: https://www.mercadopago.com.ar/developers/en/docs.

Security

•	Use HTTPS for all API communications.•	Implement data sanitization to prevent SQL injection and XSS attacks.•	Store sensitive data securely with encryption (e.g., bcrypt for passwords).•	Regularly update dependencies to avoid vulnerabilities.

Performance Optimization

•	Use caching strategies (e.g., Redis) for frequently accessed data.•	Optimize database queries using indexes and pagination.•	Profile and monitor the API performance with tools like New Relic or Datadog.•	Implement load balancing for handling high traffic.

Testing

•	Write unit tests using Jest and supertest for API routes and logic.•	Implement integration tests for end-to-end workflows.•	Use mock/stub libraries (e.g., Sinon) to simulate API responses.•	Set up CI/CD pipelines to run tests automatically on commits.

API Documentation

•	Provide detailed API documentation using Swagger.•	Include examples for each endpoint with sample request and response payloads.•	Use Postman collections for sharing API usage with other developers.

Deployment & Scaling

•	Use Docker to containerize the application for consistent deployment across environments.•	Implement CI/CD pipelines using GitHub Actions, GitLab CI, or Jenkins for automated deployments.•	Deploy to cloud platforms like AWS, Azure, or Google Cloud with load balancing and autoscaling enabled.•	Implement logging and monitoring with tools like PM2, Nginx, or ELK stack.

Key Conventions

1. Prioritize building secure, scalable, and maintainable backend solutions.2. Adhere to SOLID principles and design patterns.3. Follow Express and Node.js best practices for optimal performance.

Additional Documentation

•	Use the official Node.js documentation: https://nodejs.org/en/docs/•	Refer to Express documentation for routing, middleware, and more: https://expressjs.com/

Please and thank you!

stack:

Node.js API Guide .cursorrules prompt file

Felipe Leon

NEW

Next.js 14 Supabase TailwindCSS .cursorrules prompt file

Expert Full-Stack Web Developer Guide for Next.js 14

You are an expert full-stack web developer focused on producing clear, readable Next.js code. This guide outlines the latest best practices, conventions, and preferences for development using Next.js 14, Supabase, TailwindCSS, and TypeScript.

Core Technologies and Versions

Next.js 14 (latest stable version)
Supabase (latest stable version)
TailwindCSS (latest stable version)
TypeScript (latest stable version)

General Principles

Follow user requirements carefully
Provide accurate, factual, and thoughtful answers
Implement error handling and logging
Always add loading and error states to data fetching components
Use semantic HTML elements where possible
Optimize for Web Vitals (LCP, CLS, FID)

Next.js Best Practices

Favor React Server Components and Next.js SSR features
Minimize usage of client components ('use client')
Implement route-based code splitting
Follow Next.js documentation for Data Fetching, Rendering, and Routing

Code Style and Structure

Naming Conventions

Use kebab-case for component names (e.g., my-component.tsx)
Use lowercase with dashes for directories (e.g., components/auth-wizard)
Use camelCase for variables and functions
Use PascalCase for React components

File Structure

components/  Button/    button.tsx    button.module.styl  Card/    card.tsx    card.module.styl

Coding Standards (based on Standard.js)

Use 2 space indentation
Use single quotes for strings (except to avoid escaping)
No semicolons (unless required to disambiguate statements)
No unused variables
Add a space after keywords and before function parentheses
Always use === instead of ==
Space infix operators and after commas
Keep else statements on the same line as their curly braces
Use curly braces for multi-line if statements
Always handle the err function parameter

Best Practices

Write concise, technical JavaScript code
Use functional and declarative programming patterns; avoid classes
Prefer iteration and modularization over code duplication
Use descriptive variable names with auxiliary verbs (e.g., isLoading, hasError)
Structure files: exported component, subcomponents, helpers, static content
Favor named exports for components

React and Hooks

Use functional components with prop-types for type checking
Implement hooks correctly (useState, useEffect, useContext, useReducer, useMemo, useCallback)
Follow the Rules of Hooks
Create custom hooks for reusable component logic
Use React.memo() for component memoization when appropriate
Implement useCallback for memoizing functions passed as props
Use useMemo for expensive computations
Avoid inline function definitions in render
Prefer composition over inheritance
Use children prop and render props pattern for flexible components
Implement React.lazy() and Suspense for code splitting
Use refs sparingly and mainly for DOM access
Prefer controlled components over uncontrolled components
Implement error boundaries
Use cleanup functions in useEffect to prevent memory leaks
Use short-circuit evaluation and ternary operators for conditional rendering

State Management

Use Zustand for global state management
Lift state up when needed to share state between components
Use context for intermediate state sharing
Use 'nuqs' for URL search parameter state management

UI and Styling

Use Shadcn UI and Radix UI for component foundations
Implement responsive design with Tailwind CSS (mobile-first approach)
Use Stylus as CSS Modules for component-specific styles
Combine Tailwind utility classes with Stylus modules:
Use Tailwind for common utilities and layout
Use Stylus modules for complex, component-specific styles
Never use the @apply directive
Implement a consistent naming convention for CSS classes (e.g., BEM) within Stylus modules

Stylus Best Practices

Use variables for colors, fonts, and other repeated values
Create mixins for commonly used style patterns
Utilize Stylus' parent selector (&) for nesting and pseudo-classes
Keep specificity low by avoiding deep nesting

Performance Optimization

Minimize 'use client', 'useEffect', and 'useState'
Wrap client components in Suspense with fallback
Use dynamic loading for non-critical components
Optimize images: use WebP format, include size data, implement lazy loading
Minimize global styles; prefer modular, scoped styles
Use PurgeCSS with Tailwind to remove unused styles in production

Forms and Validation

Use controlled components for form inputs
Implement form validation (client-side and server-side)
Consider using react-hook-form for complex forms
Use Zod or Joi for schema validation

Error Handling and Validation

Prioritize error handling and edge cases
Handle errors at the beginning of functions
Use early returns for error conditions
Place the happy path last in the function
Avoid unnecessary else statements; use if-return pattern
Use guard clauses to handle preconditions and invalid states early
Implement proper error logging and user-friendly error messages
Model expected errors as return values in Server Actions

Use semantic HTML elements
Implement proper ARIA attributes
Ensure keyboard navigation support

Testing

Write unit tests for components using Jest and React Testing Library
Implement integration tests for critical user flows
Use snapshot testing judiciously

Security

Sanitize user inputs to prevent XSS attacks
Use dangerouslySetInnerHTML sparingly and only with sanitized content

Internationalization (i18n)

Use libraries like react-intl or next-i18next for internationalization

stack:

Next.js 14 Supabase TailwindCSS .cursorrules prompt file

m0r6aN

Joi .cursorrules prompt files

Joi is an open-source JavaScript library designed for object schema validation, offering developers an easy and reliable way to ensure data integrity within applications.

Node.js API Guide .cursorrules prompt file

Node.js API Guide .cursorrules prompt file

Next.js 14 Supabase TailwindCSS .cursorrules prompt file

Next.js 14 Supabase TailwindCSS .cursorrules prompt file

.cursorrules file Cursor AI Python FastAPI API

Python FastAPI Scalable API .cursorrules prompt file

Flask-RESTful JWT RESTX .cursorrules prompt file

Cursor AI React TypeScript Shadcn UI .cursorrules prompt file

Next.js React TypeScript .cursorrules prompt file

Python Pytest Typer .cursorrules prompt file

Next.js Tailwind CSS Obsidian Plugin .cursorrules prompt file

Next.js TypeScript Clerk Stripe Vercel Setup .cursorrules prompt file

React TypeScript Care Project .cursorrules prompt file

Elixir Code Guidelines .cursorrules prompt file

.cursorrules file Cursor AI Python FastAPI API

SvelteKit TailwindCSS TypeScript .cursorrules prompt file

JavaScript TypeScript Code Quality .cursorrules prompt file

Plasticode Telegram API .cursorrules prompt file

ES Module Node.js Guidelines .cursorrules prompt file

Cursor Tip

Here is a quick example of leveraging the .cursorrules file (sys

Cursor Tip

Cursor Tip

Cursor Tip

Create a Chrome Extension Fast: Cursor AI Tutorial

Build ChatGPT with Python: Cursor AI Tutorial Guide

Build AI Voice Notes App: Cursor AI Tutorial Guide

Cursor AI Tutorial: Easy Loading Page with Shadcn Components