README
Welcome to the complete documentation for moclojer - a simple and efficient HTTP mock server. This documentation is designed to help you get started quickly and become proficient with all of moclojer's features.
π Getting Started
New to moclojer? Start with our progressive tutorial series:
Overview - Learn what moclojer is and why you'd want to use it
Installation - Get moclojer running on your system
Your First Mock Server - Create a working API in 10 minutes
Dynamic Responses - Make your mocks respond to request data
Multiple Endpoints - Build complete APIs with proper structure
Real-World Example - Complete e-commerce API tutorial
π Documentation Structure
This documentation follows a progressive structure inspired by Django's excellent documentation:
π― First Steps
Perfect for beginners - get up and running quickly with guided tutorials.
π§ Core Concepts
Understand how moclojer works with detailed explanations of key concepts:
Configuration - YAML, EDN, and OpenAPI formats
Endpoints - HTTP methods, paths, and responses
Templates - Dynamic content generation
Parameters - Path, query, body, and header handling
β‘ Advanced Features
Specialized functionality for complex scenarios:
WebSocket support
External bodies
Webhooks
Rate limiting
Multi-domain support
π§ Framework Integration
Using moclojer as a library and integrating with applications:
Clojure integration
Testing workflows
Development practices
π Reference Documentation
Complete technical reference for all features:
Configuration specification
Template variables
CLI reference
FAQ and troubleshooting
π Deployment & Operations
Production deployment and operational concerns:
Docker deployment
Cloud deployment
Monitoring and security
π‘ Examples & Recipes
Practical examples and common patterns:
REST API mocking
Industry-specific examples
Integration examples
π― Learning Paths
I'm entirely new to moclojer
Read the Overview
Follow the Installation guide
Complete all tutorials in the "First Steps" section
Explore Core Concepts as needed
I want to mock a specific type of API
Check Examples & Recipes for your use case
Review relevant Core Concepts
Refer to the Configuration Specification
I'm integrating moclojer into my application
Read Using as a Library
Check Testing Integration
Review Development Workflows
I need help with a specific feature
Check the FAQ first
Search the Reference Documentation
Look for examples in Examples & Recipes
π Quick Reference
Common Tasks
Create your first mock: Your First Mock Server
Use path parameters: Dynamic Responses
Handle JSON data: Template Variables
Mock WebSockets: WebSocket Support
Load external data: External Bodies
Configuration Reference
All template variables: Template Variables Reference
Complete YAML specification: Configuration Specification
CLI options: CLI Reference
Troubleshooting
Common issues: FAQ
Detailed troubleshooting: Troubleshooting Guide
πββοΈ Running Documentation Locally
You can run this documentation locally using the included server:
# Navigate to the moclojer directory
cd moclojer
# Start the documentation server
node serve-docs.js
# Open http://localhost:3000 in your browser
The local server provides:
Full navigation
Search functionality
Mobile-responsive design
Fast loading
π€ Contributing to Documentation
We welcome contributions to improve the documentation! Here's how you can help:
Quick Fixes
Fix typos or broken links
Improve unclear explanations
Add missing examples
Larger Contributions
Write new tutorials
Add industry-specific examples
Improve existing guides
Translate content
How to Contribute
Fork the repository
Make your changes in the
docs/
directoryTest locally using
node serve-docs.js
Submit a pull request
Writing Guidelines
Use clear, simple language - Write for developers of all skill levels
Include practical examples - Show, don't just tell
Follow the progressive structure - Start simple, add complexity gradually
Test all code examples - Ensure examples actually work
Use proper Markdown formatting - Follow existing style
π Getting Help
Community Resources
GitHub Discussions - Ask questions and share ideas
GitHub Issues - Report bugs or request features
Documentation Issues
If you find problems with the documentation:
Check if it's already reported in GitHub Issues
Create a new issue with:
Clear description of the problem
Which page/section is affected
Suggested improvement (if applicable)
π Documentation License
This documentation is part of the moclojer project and follows the same MIT license as the main project.
Ready to get started? Begin with the Overview to learn what moclojer can do for you! π
Last updated
Was this helpful?