NimbusWave

NimbusWave is an AI-powered edge deployment platform that helps developers seamlessly deploy and scale their JavaScript web applications using Cloudflare Workers. Simply upload your build folder, and our AI assistant will guide you through the deployment process.

🌟 Features

• AI-Guided Deployments: An Intelligent AI Agent helps you through the entire deployment process and deploys your app directly to the edge
• Edge-First Architecture: Built on Cloudflare Workers for optimal performance
• Zero Configuration: Upload your build folder, and we handle the rest
• Instant Deployments: No cold starts, lightning-fast deployments
• Global Scale: Leverage Cloudflare's global network
• Framework Agnostic: Deploy any JavaScript/TypeScript web application

🚀 Getting Started

Prerequisites

• Node.js >= 20.0.0
• npm

Installation

# Clone the repository
git clone https://github.com/Mayuresh-22/nimbuswave.git

# Navigate to the project directory
cd NimbusWave

# Install dependencies
npm install

# Make sure you add all the environment variables in
# /server/.dev.vars.example and rename to .dev.vars
# same for /app/.env.example

# Install app dependencies
cd /app
npm install
npm run dev

# Install server dependencies
cd /server
npm install
npm run dev

🏗️ Project Structure

NimbusWave/
├── app/                    # Frontend application (Vite + React)
│   ├── src/               # Source files
│   └── package.json       # Frontend dependencies
├── server/                # Backend application (Hono.js)
│   ├── src/              # API source files
│   └── package.json      # Backend dependencies
└── package.json          # Root package.json

🛠️ How It Works

1. Upload: Users upload their web application's build folder (as a ZIP file)
2. Process: NimbusWave's AI Agent processes the files and uploads them to Cloudinary
3. Deploy: The application is deployed to Cloudflare's edge network
4. Access: Users receive a unique URL to access their deployed application

Technical Implementation

• AI Agent: NimbusWave's AI Agent is powered by Mastra.ai
• Edge Network: Utilises Cloudflare Workers for serverless deployment
• File Storage: Cloudinary for static asset management
• Frontend: Built with Vite and React for optimal development experience
• Backend: Powered by Hono.js for efficient API handling
• Zero Cold Starts: Leverages Cloudflare's always-hot edge network

🧪 Development

# Run frontend
cd app
npm run dev

# Run backend
cd server
npm run dev

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

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

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

✨ Contributors

🌐 Links

• Coming soon...

🙏 Acknowledgments

• Mastra AI
• Cloudflare Workers
• Cloudinary
• Hono.js
• Vite

---

Made with ❤️ by the NimbusWave team