Skip to content
 
 

Repository files navigation

AutoWRX

AutoWRX is a cloud-based, rapid-prototyping environment for software-defined vehicle (SDV) applications. It lets developers build and test SDV features against real-world vehicle APIs in the browser, with seamless migration to automotive runtimes like Eclipse Velocitas. It is part of the digital.auto ecosystem.

The platform lets developers:

  • Browse and explore vehicle API catalogs
  • Build and test prototypes in the browser using Python, C++, or Rust
  • Visualize real-time signal data from vehicle runtimes
  • Connect to KUKSA Data Broker and other automotive services
  • Showcase customer journeys and feature demos
  • Migrate prototypes to production automotive runtimes

📚 Documentation

All documentation lives in docs/. Start there:

  • New here? → Getting Started — concepts, local setup, codebase tour, and how to contribute.
  • How it's built → Architecture — a comprehensive, code-verified deep-dive.
  • Full index → docs/README.md — everything, organized.

Quick start

Run the full stack locally (details in Local Development):

# 1. MongoDB (Docker)
docker run -d --name autowrx-mongodb -p 27017:27017 \
  -v autowrx-dev-dbdata:/data/db mongo:4.4.6-bionic

# 2. Backend  → http://localhost:3200
cd backend && yarn install && yarn dev

# 3. Frontend → http://localhost:3210   (new terminal)
cd frontend && yarn install && yarn dev

Open the app at http://localhost:3210.


Project structure

This is a monorepo:

  • frontend/ — React / Vite / TypeScript SPA (details · architecture)
  • backend/ — Node.js / Express API + MongoDB (details · architecture)
  • docs/ — documentation (index)
  • instance-setup/ — production docker-compose + guides
  • .github/workflows/ — CI: docker build/release, dev-stage deploy

The backend also serves the built frontend in production, so the two ship as one image.


Technology stack

  • Frontend: React, TypeScript, Vite, Tailwind CSS, TanStack Query, Zustand
  • Backend: Node.js, Express, MongoDB, Mongoose, Passport (JWT), Socket.IO
  • Infrastructure: Docker, Docker Compose

Contributing

Contributions are welcome. AutoWRX is an Eclipse Foundation project — please read the Contributing guide first, which covers the required Eclipse Contributor Agreement (ECA), the branch/PR flow, and how to verify your change locally.


License

License: MIT

Copyright (c) 2025 Eclipse Foundation.

This program and the accompanying materials are made available under the terms of the MIT License which is available at https://opensource.org/licenses/MIT.

SPDX-License-Identifier: MIT


Links

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages