Smart OpenAPI to Frontend Service Code Generator

Swag-Gen is a powerful CLI tool that automatically generates frontend service code from OpenAPI specifications. It creates a complete, production-ready service layer with built-in session management, multiple storage adapters, and flexible HTTP client support.

• Complete Project Structure - Generates a fully organized project with proper separation of concerns
• Intelligent Session Management - Automatic handling of cookies, tokens, and authentication state
• Cross-Platform Support - Works seamlessly with React Native, Expo, and Next.js
• Flexible Storage Layer - Supports Cookie, LocalStorage, and AsyncStorage (for Expo)
• Dual HTTP Clients - Choose between Fetch API or Axios
• Full TypeScript Support - Complete type safety with intelligent autocomplete

• Auto-generated Service Harmony - Perfect integration between all layers of your application
• Next.js Special Modules - Built-in support for SSR, ISR, and middleware
• Error Handling & Retry Logic - Production-ready error management
• Request Caching - Built-in performance optimization

Install globally using npm or yarn:

npm:

npm install @abolfask/swag-gen -g

yarn:

yarn global add @abolfask/swag-gen

Basic command structure:

swag-gen [options]

1. Generate JavaScript services from local file:

swag-gen --input ./openapi.json

2. Generate TypeScript services from URL:

swag-gen --url https://api.example.com/openapi.json --typescript

3. Generate with Axios and cookie management for Expo:

swag-gen -i ./swagger.yaml -a

4. Generate complete Next.js project with TypeScript:

swag-gen --url https://api.site.com/openapi.json --ts --axios

After execution, you'll get:

services/
├── network.js/.ts    # Core HTTP client and request handling
├── apiClient.js/.ts  # Generated API services
├── cookie.js/.ts     # Session storage modules (Cookie/LocalStorage/AsyncStorage)

Automatic AsyncStorage and cookie management - no more token storage headaches

Full server and client support with automatic request header management

Lightweight, reusable services for any frontend project

1. Parse & Validate - Reads and validates your OpenAPI specification
2. Generate Core - Creates the main HTTP client and request handlers
3. Generate Services - Produces service functions/classes for each endpoint
4. Integrate Storage - Implements the session storage layer
5. Output - Writes all generated files to disk

• ✅ 90% Less Boilerplate - Run one command instead of writing repetitive code
• ✅ No Vendor Lock-in - Switch between Fetch and Axios anytime
• ✅ Professional Auth Management - Supports multiple storage methods out of the box
• ✅ Type Safe - Full TypeScript support with compile-time error checking
• ✅ Extensible - Easy to add custom modules and adapters

Contributions are welcome!

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

ISC License - see LICENSE.md

Built with ❤️ for the developer community