Skip to content
This repository was archived by the owner on Apr 5, 2026. It is now read-only.
skitsanos edited this page Jul 20, 2025 · 19 revisions

Welcome to Foxx Builder 🚀

The fastest way to build production-ready APIs with ArangoDB

Why Foxx Builder Exists

Traditional backend development often feels like you're fighting against your tools instead of building your product. You spend more time configuring servers, managing dependencies, and writing boilerplate than actually solving business problems.

What if your API could live right next to your data? That's exactly what Foxx Builder enables.

The ArangoDB Foxx Advantage

ArangoDB's Foxx framework lets you write microservices that run directly inside your database. Think of it as having your API server and database merged into one powerful system:

  • Zero network latency between your logic and data
  • 🔒 Built-in security with native database access controls
  • 📦 No external dependencies - everything runs in one process
  • 🎯 JavaScript you already know - same V8 engine as Node.js

But here's the problem: Raw Foxx services require a lot of manual setup and boilerplate code. That's where Foxx Builder comes in.

How Foxx Builder Transforms Development

Before Foxx Builder (Traditional Foxx):

❌ Manual route registration for every endpoint
❌ Repetitive validation code for each request
❌ Complex setup scripts and manifest configuration
❌ No standardized project structure
❌ Manual testing setup and deployment scripts

With Foxx Builder:

✅ File-based routing - just create files in /routes folder
✅ Built-in validation with simple configuration
✅ Automated setup with smart defaults
✅ Familiar folder structure inspired by Next.js
✅ One-command testing and deployment

Result? You go from idea to working API in minutes, not hours.

What Makes Our Approach Different

🎯 Convention Over Configuration

Inspired by the best practices from Next.js and modern frontend frameworks, Foxx Builder uses intuitive file-based routing. Want a /users endpoint? Just create routes/users/get.js. No manual route registration needed.

🛠 Developer Experience First

  • One-command setup: task docker-db-setup && task deploy-docker
  • Instant testing: task test runs your entire API test suite
  • Live reloading: Changes deploy instantly with task deploy-docker
  • Modern CI/CD: GitHub Actions integration out of the box

🚀 Production Ready from Day One

  • Automated testing with Hurl
  • Built-in security best practices
  • Comprehensive error handling
  • Performance optimizations included

Real-World Impact

Instead of spending weeks setting up infrastructure, our users typically have a working API with authentication, validation, and testing in under 30 minutes.

Compare that to traditional approaches where you might spend days just configuring Express.js, setting up database connections, writing middleware, and creating deployment pipelines.

🚀 Getting Started

🛠 Core Development

🔧 Advanced Topics

🌐 Integrations

Clone this wiki locally