Skip to content

Latest commit

 

History

History
171 lines (147 loc) · 21 KB

README.md

File metadata and controls

171 lines (147 loc) · 21 KB

Daffodil

Chat on Discord Build Status Maintainability Test Coverage experimental

Table of contents

What is Daffodil?

In general, Daffodil is a frontend Ecommerce framework that allows developers to build complex Ecommerce stores.

Specifically, Daffodil is a frontend toolkit that accomplishes three things:

  1. Improve developer workflow when writing frontend software for Ecommerce stores.
  2. Provide a consistent frontend developer tool-chain regardless of a business's chosen ecommerce platform.
  3. Drastically improve the end-user experience of online-shopping.

What are Daffodil's features?

Daffodil's features include the following:

  • 🆓 Forever Free, Open Source, and MIT Licensed
  • 🔨 Platform Agnostic Drivers for your platform of choice
    • Shopify
    • Magento 2
    • In-Memory Backend
      • Prebuilt
      • ⚡ Great for lightning fast iteration and concepting
  • 🍰 Decoupled and Composable Packages for your use case
    • Product
    • Cart
    • Checkout
  • 📚 Well Documented
    • Example Implementation
    • API References
    • Tutorials
  • 💡 Component Kit
    • Purely Functional
    • Themeable
    • Accessible
    • Supports Server-side Rendering
    • Well Tested
    • Fantastic Performance
    • IE 11+ Support

What do I need before I start using Daffodil?

Daffodil was developed so you can get started without connecting to a platform. Because of its driver-like nature, all you need is the following:

  1. Node.js v18+
  2. npm
  3. An Angular 17 project

How do I start using Daffodil?

After installing the prerequisites, you can choose the packages that you want and get started using Daffodil with your new or existing Ecommerce store.

Who uses Daffodil and why?

The target devopers for Daffodil include, but are not limited to, the following:

  1. Developers who want to explore and experiment with Progressive Web Apps (PWAs).
  2. Developers who are comfortable with Angular and are interested in job opportunities in Ecommerce.
  3. Developers who work with businesses that have existing websites but want a better user interface and experience.
  4. Developers who are forward-thinking, have gone through a re-platforming, and want to deflect future re-platforming.

What packages do I use?

For a basic Ecommerce site, you need all of the most commonly used packages (common packages), which are the following:

Note: Both the core and driver packages are dependencies for most other packages. Developers do not interact with these packages directly.

Referring to the aforementioned use cases, here are some lists and explanations of recommended Daffodil packages.

1. To explore and experiment with PWAs

If you don't have a project in mind and want to see something in Daffodil working, then use:

2. To expand Ecommerce opportunities

If you want to expand your portfolio for more Ecommerce opportunities, then use the common packages and optionally include:

You won't need to use more than the aforementioned common packages(#pwapackages) until you have a specific business use or requirement. However, if you are design-focused, then you can either use your own design framework or use the design package.

3. To improve the user experience for existing business sites

If you have an existing site, either your own or backed by a business, then there are a few working assumptions about the site: it has SEO and specific URLs, and the product pages need to show lists of related products. So, in addition to the common packages, you may need the following packages:

4. To prevent future re-platforming

If you want to prevent future re-platforming of your Ecommerce site, there are a few assumed advanced requirements. For example, the business has complex product configurations and has marketing email campaigns. So, in addition to the common packages and the packages for improving user experiences, you may also need the following packages:

Packages

Below is a table of currently available Daffodil packages.

Package Version Stability
@daffodil/analytics latest experimental
@daffodil/analytics-provider-data-layer latest experimental
@daffodil/auth latest experimental
@daffodil/authorizenet latest experimental
@daffodil/cart latest experimental
@daffodil/cart-customer latest experimental
@daffodil/cart-store-credit latest experimental
@daffodil/category latest experimental
@daffodil/checkout latest experimental
@daffodil/contact latest experimental
@daffodil/content latest experimental
@daffodil/core latest experimental
@daffodil/customer latest experimental
@daffodil/customer-auth latest experimental
@daffodil/customer-order latest experimental
@daffodil/customer-payment latest experimental
@daffodil/customer-payment-authorizenet latest experimental
@daffodil/customer-store-credit latest experimental
@daffodil/design latest experimental
@daffodil/driver latest experimental
@daffodil/external-router latest experimental
@daffodil/forms latest experimental
@daffodil/geography latest experimental
@daffodil/navigation latest experimental
@daffodil/newsletter latest experimental
@daffodil/order latest experimental
@daffodil/payment latest experimental
@daffodil/paypal latest experimental
@daffodil/product latest experimental
@daffodil/product-composite latest experimental
@daffodil/product-configurable latest experimental
@daffodil/related-products latest experimental
@daffodil/reviews latest experimental
@daffodil/router latest experimental
@daffodil/search latest experimental
@daffodil/search-category latest experimental
@daffodil/search-product latest experimental
@daffodil/search-product-composite latest experimental
@daffodil/search-product-configurable latest experimental
@daffodil/seo latest experimental
@daffodil/ssr latest experimental
@daffodil/upsell-products latest experimental

Note: About the checkout package, it is currently a legacy package; there is no reason to use it. However, the checkout package eventually may be filled with extracts from the cart and order packages.