A modern, powerful, and intuitive OpenAPI specification editor with real-time preview and validation.
Features • Getting Started • Usage • Shortcuts • Contributing
- Dark/Light Theme Support: Seamlessly switch between themes
- Split View: Edit and preview simultaneously
- Responsive Design: Works on all screen sizes
- Customizable Layout: Collapsible sidebar and preview panel
- Monaco Editor Integration: VS Code-like experience
- Syntax Highlighting: YAML/JSON support
- Auto-completion: Context-aware suggestions
- Real-time Validation: Instant feedback on errors
- Format on Save: Keep your code clean
- Real-time Updates: See changes instantly
- Interactive Documentation: Collapsible sections
- Search & Filter: Find endpoints quickly
- Tag-based Navigation: Organize by tags
- Color-coded Methods: Visual HTTP method identification
- File Management: Create, open, and save files
- Export Options: YAML/JSON conversion
- Keyboard Shortcuts: Efficient workflow
- Git Integration: Version control support
- Multiple Files: Work on multiple specs
- Node.js 16.x or later
- npm or yarn
# Clone the repository
git clone https://github.com/yourusername/openapi-editor.git
# Navigate to the project directory
cd openapi-editor
# Install dependencies
npm install
# or
yarn install
# Start the development server
npm run dev
# or
yarn dev
-
Create New File
- Click the "+" button in the toolbar
- Use
Ctrl+N
shortcut
-
Open File
- Click "Open" in the toolbar
- Drag & drop files
- Use
Ctrl+O
shortcut
-
Save File
- Click "Save" in the toolbar
- Use
Ctrl+S
shortcut
-
Export
- Export as YAML/JSON
- Download documentation
- Adjust font size
- Toggle word wrap
- Show/hide minimap
- Configure tab size
- Filter by tags
- Search endpoints
- Expand/collapse all
- Copy endpoint URLs
Action | Windows/Linux | macOS |
---|---|---|
New File | Ctrl+N |
⌘+N |
Open File | Ctrl+O |
⌘+O |
Save | Ctrl+S |
⌘+S |
Format | Shift+Alt+F |
⇧+⌥+F |
Toggle Preview | Ctrl+P |
⌘+P |
Find | Ctrl+F |
⌘+F |
Toggle Sidebar | Ctrl+B |
⌘+B |
{
"editor": {
"theme": "vs-dark",
"fontSize": 14,
"tabSize": 2,
"wordWrap": "on",
"formatOnSave": true,
"minimap": true
}
}
{
"theme": {
"light": {
"primary": "#0284c7",
"background": "#ffffff",
"foreground": "#0f172a"
},
"dark": {
"primary": "#38bdf8",
"background": "#0f172a",
"foreground": "#f8fafc"
}
}
}
We welcome contributions! Please follow these steps:
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.