Using Windsurf with Igniter.js for AI-Powered Development
Windsurf, the AI-native code editor from Codeium, can dramatically accelerate your TypeScript and Node.js development. To unlock its full potential, you need to provide it with the right context. This guide shows you how to train Windsurf to be an Igniter.js expert, leading to more accurate code generation, better suggestions, and a streamlined AI-powered workflow.
Method 1: Train Windsurf on the Igniter.js Core
This method gives Windsurf's AI a deep, foundational understanding of the entire Igniter.js ecosystem by pointing it to our official, comprehensive documentation file. This is the recommended approach for any existing project that was not created from an official template.
Step 1: Create a Workspace Rules Directory
In the root of your project, create a new directory for Windsurf's rules. This specific folder is where Windsurf looks for context files.
mkdir -p .windsurf/rules
Step 2: Create a Rule File
Inside that directory, create a new Markdown file. You can name it igniter-core.md.
Step 3: Add the Rule Content
Open .windsurf/rules/igniter-core.md and paste the following content. This rule instructs Windsurf's AI to use our llms.txt—a single file containing our entire documentation—as its primary source of knowledge.
# Igniter.js Expert
You are an expert developer specializing in Igniter.js. Your primary source of knowledge for all framework-related questions and code generation is the official documentation, which can be found in its entirety at: https://igniterjs.com/llms.txt.
Always adhere to the patterns and best practices described in that document. Before answering any question, consult this source to ensure accuracy.
With this rule in place, every interaction you have with Windsurf's AI will be informed by the complete Igniter.js documentation, leading to highly accurate and relevant assistance.
Method 2: Use an Official Igniter.js Template (The Easy Way)
The easiest way to work with Windsurf is by starting your project with one of our official templates. These starters are pre-configured to be "AI-Friendly" and work seamlessly with AI-native editors.
When you create a project from a template, it automatically includes a detailed AGENT.md file in the root directory. Windsurf is designed to detect and use files like AGENT.md as a project-specific instruction set. This means that when you open an Igniter.js template project in Windsurf, the AI is already trained on your specific codebase's architecture and conventions with no additional setup required.
🚀 Enhanced with MCP Server
Our official templates now include a MCP Server that provides Windsurf with direct access to your project through standardized tools. This means Windsurf can:
- Analyze your codebase with deep understanding of your project structure
- Execute development commands like starting the dev server or running tests
- Generate code scaffolding for features, controllers, and procedures
- Manage tasks and projects with built-in project management tools
- Access your project's memory to remember architectural decisions and patterns
- Delegate work to specialized AI agents for complex tasks
Adding MCP Server to Windsurf
To enable the MCP Server integration with Windsurf:
Option 1: Via Windsurf MCP Plugin Store (Recommended)
Use the Igniter.js MCP plugin from the Windsurf MCP Plugin Store for the simplest setup.
Option 2: Via Windsurf Settings UI
- Open Windsurf Settings (via Windsurf - Settings > Advanced Settings or Command Palette > Open Windsurf Settings Page)
- Select Cascade in the settings sidenav
- Click Add Server
- Add the Igniter.js configuration:
{
"mcpServers": {
"Igniter": {
"command": "npx",
"args": ["@igniter-js/mcp-server"]
}
}
}
Option 3: Global Configuration
Manually add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"Igniter": {
"command": "npx",
"args": ["@igniter-js/mcp-server"]
}
}
}
This gives Windsurf direct access to powerful development tools that understand your Igniter.js project deeply.
Learn more about our MCP Server and Next.js Starter Rules.
Recommended Project Templates
Our templates come ready with everything you need to start building, including the AI instructions that Windsurf will automatically use.
