Sylius FrontWing (React + Remix + Vite)

This is a headless frontend project for Sylius, built with React, Remix, and Vite.
The goal is to provide a modern, fast, and flexible frontend for Sylius-based eCommerce platforms using a fully decoupled architecture.

⚠️ Note: This project is currently under active development and is not production-ready yet. While many core features and Sylius pages are already implemented, some functionalities are still being finalized.

---

✨ Features

• 🧩 Modular, component-based architecture in React
• ⚡ Blazing fast development experience with Vite and HMR
• 🛒 Integration with Sylius API (v2) for:
  • Homepage and category listing
  • Product detail pages
  • Cart management
  • Checkout flow
  • Customer account area (dashboard, orders, profile, address book)
• 🎨 Styling based on Bootstrap 5
• 🔄 Client-side routing powered by Remix

---

📦 Tech Stack

• React
• Remix
• Vite
• Bootstrap 5
• TanStack Query (React Query)
• TypeScript

🚧 Development Roadmap

The following features are planned as next milestones:

• Implement server-side rendering (SSR)
• Add i18n and multilingual support
• Add frontend form validation
• Optimize API queries

---

🏁 Getting Started

✅ Requirement: Node.js v20 or higher

Make sure you have a Sylius backend with the API enabled.

Create a fork of this repository and clone it to your local machine

npm install
npm run dev

Then open http://localhost:5137 in your browser.

💬 Join the Community

If you have questions, want to share feedback, or discuss Sylius headless use cases, join the Sylius Slack community and come say hi in the #react-front channel:

👉 https://sylius.com/slack

📄 License

FrontWing is completely free and released under the MIT License.

🤝 Contributing

This project is still evolving, but contributions are welcome! Feel free to open an issue, suggest improvements, or submit a pull request.