Fixes #226: Better explanation of this project at README.md

README.md

@@ -1,6 +1,41 @@
 # Storefront — deco.cx template
 
-Welcome to your [deco.cx](https://deco.cx) site!
+A **production-ready e-commerce storefront template** built on [deco.cx](https://deco.cx). This template provides a complete headless commerce solution with multi-platform support, enabling you to quickly build modern, high-performance online stores.
+
+## What is this?
+
+This is a full-featured e-commerce storefront that includes:
+
+- **Complete Shopping Experience**: Product listings, search, filtering, cart, wishlist, and checkout
+- **Multi-Platform Support**: Works with VTEX, Shopify, WakeCommerce, Linx, Nuvemshop, VNDA, and custom platforms
+- **Visual CMS Integration**: No-code/low-code content management through the deco.cx platform
+- **Modern Tech Stack**: Built with Deno, Fresh framework, Preact, and Tailwind CSS
+- **Performance Optimized**: Server-side rendering, image optimization, and PWA-ready
+- **Modular Architecture**: Mix and match reusable sections to build custom page layouts
+
+## Key Features
+
+### E-Commerce Core
+- Product catalog with details, images, and variants
+- Advanced search with filters and sorting
+- Shopping cart and mini cart
+- User authentication and profiles
+- Wishlist functionality
+- Category browsing
+
+### Marketing & Content
+- Hero sections and banners
+- Product shelves and carousels
+- Newsletter integration
+- Campaign timers
+- Social media integration (Instagram, WhatsApp)
+- SEO-friendly structure
+
+### Developer Experience
+- TypeScript with full type safety
+- Hot module reloading
+- Component-based architecture
+- Easy platform switching via configuration
 
 ## Usage