Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

Update quick start guide for Spree 5 (#12464)

Damian Legawiec914d37552f61
diff --git a/bin/sandbox.sh b/bin/sandbox.sh
index 806c3048f6..a7733de30c 100755
--- a/bin/sandbox.sh
+++ b/bin/sandbox.sh
@@ -76,7 +76,7 @@ bin/rails g devise:install
bin/rails g devise Spree::User
# setup spree
-bin/rails g spree:install --auto-accept --user_class=Spree::User --authentication=devise --install_storefront=true --install_admin=true
+bin/rails g spree:install --auto-accept --user_class=Spree::User --authentication=devise --install_storefront=true --install_admin=true --sample=true
# setup letter_opener
cat <<RUBY >> config/environments/development.rb
diff --git a/core/config/locales/en.yml b/core/config/locales/en.yml
index ba4746cac4..7802d8ccd7 100644
--- a/core/config/locales/en.yml
+++ b/core/config/locales/en.yml
@@ -1404,8 +1404,8 @@ en:
heading_default: Welcome to your website
text_default: This is the place to tell people about your business and what you do.
image_with_text:
- heading_default: Welcome to my online store!
- text_default: Hi, I'm %{store_name}. I enjoy life and love to share our experiences and energy with you and the world! And here we can share some of our favorite things as well.
+ heading_default: Welcome to our shop!
+ text_default: At %{store_name} we offer a wide range of products for your home and business.
newsletter:
heading_default: Subscribe to our newsletter
text_default: Thank you for choosing us as your trusted online shopping destination.
diff --git a/docs/developer/getting-started/adding_spree_to_rails_app.mdx b/docs/developer/getting-started/adding_spree_to_rails_app.mdx
index ce7ecbad9e..103ae77d6c 100644
--- a/docs/developer/getting-started/adding_spree_to_rails_app.mdx
+++ b/docs/developer/getting-started/adding_spree_to_rails_app.mdx
@@ -7,6 +7,10 @@ description: This guide will show you how to add Spree to an existing Ruby on Ra
If you followed the [Quickstart guide](quickstart) you can skip this page and go to the [Core Concepts](../core-concepts) section.
</Note>
+<Warning>
+ This guide is aimed at advanced users who want to add Spree to an existing Rails application. If you are new to Spree, please follow the [Quickstart guide](quickstart).
+</Warning>
+
## Overview
If you already have a Ruby on Rails application, you can add Spree to it by following these steps.
@@ -18,13 +22,12 @@ If you already have a Ruby on Rails application, you can add Spree to it by foll
Add these lines to your project `Gemfile`:
```ruby
- gem 'spree', '~> 4.7' # core and API
- gem 'spree_backend', '~> 4.7' # Admin panel (optional)
- gem 'spree_frontend', '~> 4.7' # Storefront (optional)
- gem 'spree_emails', '~> 4.7' # transactional emails (optional)
- gem 'spree_sample', '~> 4.7' # dummy data like products, taxons, etc (optional)
- gem 'spree_auth_devise', '~> 4.6' # Devise integration (optional)
- gem 'spree_gateway', '~> 3.11' # payment gateways eg. Stripe, Braintree (optional)
+ spree_opts = { 'github': 'spree/spree', 'branch': 'main' }
+ gem 'spree', spree_opts # core and API
+ gem 'spree_admin', spree_opts # Admin panel (optional)
+ gem 'spree_storefront', spree_opts # Storefront (optional)
+ gem 'spree_emails', spree_opts # transactional emails (optional)
+ gem 'spree_sample', spree_opts # dummy data like products, taxons, etc (optional)
```
And run the following command to install the gems:
@@ -38,11 +41,7 @@ If you already have a Ruby on Rails application, you can add Spree to it by foll
These commands will run generators which will perform operations required for Spree to work properly.
```bash
- bin/rails g spree:install --user_class=Spree::User
- bin/rails g spree:backend:install
- bin/rails g spree:frontend:install
- bin/rails g spree:auth:install
- bin/rails g spree_gateway:install
+ bin/rails g spree:install --user_class=Spree::User --install_admin=true --install_storefront=true --authentication=devise
```
### Installation options
@@ -86,7 +85,7 @@ Feel free to explore your store. You can do so because Spree comes with a defaul
Upon successful authentication, you should see the admin screen:
- ![](/images/admin_panel_978-2x.jpg)
+ ![](https://vendo-production-res.cloudinary.com/image/upload/v1740668008/docs/admin_dashboard.png)
Feel free to explore some of the Admin Panel features that Spree has to offer and to verify that your installation is working properly.
</Accordion>
diff --git a/docs/developer/getting-started/quickstart.mdx b/docs/developer/getting-started/quickstart.mdx
index 041051fc21..e88a2c7d76 100644
--- a/docs/developer/getting-started/quickstart.mdx
+++ b/docs/developer/getting-started/quickstart.mdx
@@ -16,42 +16,93 @@ Welcome to the Spree Commerce [open-source eCommerce](https://github.com/spree/s
### 1. Installing Spree
<AccordionGroup>
- <Accordion icon="github" title="Creating Your Spree Repository">
- To create your Spree store repository please, follow these instructions:
+ <Accordion icon="github" title="Getting the Spree Starter template">
+ <Info>
+ Spree Starter is a pre-configured Rails application that comes with Spree Commerce and some other useful gems installed. It is highly recommended to use Spree Starter to get started with Spree Commerce.
+ </Info>
- [Use Spree starter template](https://github.com/new?template_name=spree_starter\&template_owner=spree) to create your own repository
- </Accordion>
-
- <Accordion icon="rectangle-terminal" title="Setting up Your Development Environment">
<Note>
If you're on Windows remember to [install the Linux subsystem](https://docs.microsoft.com/en-us/windows/wsl/install-win10) before proceeding.
</Note>
- 1. Install [git](https://github.com/git-guides/install-git), [Ruby](https://www.ruby-lang.org/en/documentation/installation) and [Docker Desktop](https://docs.docker.com/get-docker)
+ 1. Install [git](https://github.com/git-guides/install-git) if you don't have it already.
- 2. Once git is installed, clone your docs repository using
+ 2. Clone the Spree starter template:
- ```basgh
- git clone <your-repo>
- ```
+ ```bash
+ git clone https://github.com/spree/spree_starter.git
+ ```
+
+ 3. Go to the repository directory:
+
+ ```bash
+ cd spree_starter
+ ```
+
+ </Accordion>
+
+ <Accordion icon="rectangle-terminal" title="Setting up Your Development Environment">
+ Now that you have the Spree Starter template, you can start setting up your development environment.
+
+ 1. Install required dependencies
+
+ On MacOS you can install the dependencies using [Homebrew package manager](https://brew.sh/):
+
+ ```bash
+ brew install vips libpq
+ ```
+
+ On debian-based systems you can install the dependencies using the package manager:
- <Info>
- If you haven't set it up yet, now would be a good time to do so with these [SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)
- </Info>
+ ```bash
+ sudo apt-get install libvips-dev libpq-dev
+ ```
- 3. Open a terminal and go to the repository directory
+ 2. Install Ruby
- 4. Run setup commands:
+ Spree is based on [Ruby and Rails](https://rubyonrails.org/), hence you need to install Ruby language.
+
+ Install [rbenv (ruby version manager)](https://github.com/rbenv/rbenv):
+
+ ```bash
+ curl -fsSL https://rbenv.org/install.sh | bash
+ ```
+
+ And now install Ruby 3.3:
+
+ ```bash
+ rbenv init && rbenv install && rbenv global 3.3.0
+ ```
+
+ 3. Install [Docker Desktop](https://docs.docker.com/get-docker)
+
+ 4. Start Docker Compose services:
+
+ <Info>
+ Docker needs to be running before running the setup commands.
+ </Info>
+
+ ```bash
+ docker compose up -d
+ ```
+
+ This will start the PostgreSQL database which is required for Spree to work. You can also use other databases like MySQL.
+
+ 5. Run setup commands:
```bash
bin/setup
```
- 5. And finally start the development server with:
+ This will install the necessary gems, run the database migrations and seed the database with some sample data.
+
+ 6. And finally start the development server with:
```bash
- bin/rails s
+ bin/rails dev
```
+
+ This will start the development server on [http://localhost:3000](http://localhost:3000).
</Accordion>
<Accordion icon="box" title="Adding sample data">
@@ -79,7 +130,7 @@ Feel free to explore your store. You can do so because Spree comes with a defaul
Upon successful authentication, you should see the admin screen:
- ![](/images/admin_panel_978-2x.jpg)
+ ![](https://vendo-production-res.cloudinary.com/image/upload/v1740668008/docs/admin_dashboard.png)
Feel free to explore some of the Admin Panel features that Spree has to offer and to verify that your installation is working properly.
</Accordion>
@@ -87,7 +138,7 @@ Feel free to explore your store. You can do so because Spree comes with a defaul
<Accordion icon="palette" title="Browsing Storefront">
Spree comes with a default pre-built Storefront. You can access it by navigating to [http://localhost:3000](http://localhost:3000).
- You can later customize this Storefront or choose another one if you prefer Next.js or Vue.js.
+ You can learn more about Storefront configuration in the [Storefront](/user/storefront/theme-editor) section.
</Accordion>
</AccordionGroup>
diff --git a/docs/images/Screenshot 2023-10-31 at 18.57.13.png b/docs/images/Screenshot 2023-10-31 at 18.57.13.png
deleted file mode 100644
index 7abba91a77..0000000000
Binary files a/docs/images/Screenshot 2023-10-31 at 18.57.13.png and /dev/null differ
diff --git a/docs/images/Spree Login.png b/docs/images/Spree Login.png
deleted file mode 100644
index a2edd953b6..0000000000
Binary files a/docs/images/Spree Login.png and /dev/null differ
diff --git a/docs/images/Spree Vue Storefront.png b/docs/images/Spree Vue Storefront.png
deleted file mode 100644
index 2a7f715f9e..0000000000
Binary files a/docs/images/Spree Vue Storefront.png and /dev/null differ
diff --git a/docs/images/admin_panel_978-2x.jpg b/docs/images/admin_panel_978-2x.jpg
deleted file mode 100644
index 852135bad9..0000000000
Binary files a/docs/images/admin_panel_978-2x.jpg and /dev/null differ
diff --git a/docs/images/admin_panel_978-2x.png b/docs/images/admin_panel_978-2x.png
deleted file mode 100644
index 9395830534..0000000000
Binary files a/docs/images/admin_panel_978-2x.png and /dev/null differ
diff --git a/docs/images/clo1 (1).png b/docs/images/clo1 (1).png
deleted file mode 100644
index 72f6b10940..0000000000
Binary files a/docs/images/clo1 (1).png and /dev/null differ
diff --git a/docs/images/clo1.png b/docs/images/clo1.png
deleted file mode 100644
index 014310a1fc..0000000000
Binary files a/docs/images/clo1.png and /dev/null differ
diff --git a/docs/images/clo2.png b/docs/images/clo2.png
deleted file mode 100644
index 2ae414d713..0000000000
Binary files a/docs/images/clo2.png and /dev/null differ
diff --git a/docs/images/clo3.png b/docs/images/clo3.png
deleted file mode 100644
index 6dbcf41e0b..0000000000
Binary files a/docs/images/clo3.png and /dev/null differ
diff --git a/docs/images/cre1.png b/docs/images/cre1.png
deleted file mode 100644
index 29eb0010e8..0000000000
Binary files a/docs/images/cre1.png and /dev/null differ
diff --git a/docs/images/cre2.png b/docs/images/cre2.png
deleted file mode 100644
index 1183d72671..0000000000
Binary files a/docs/images/cre2.png and /dev/null differ
diff --git a/docs/images/del.png b/docs/images/del.png
deleted file mode 100644
index 958ca8b0af..0000000000
Binary files a/docs/images/del.png and /dev/null differ
diff --git a/docs/images/erd.jpg b/docs/images/erd.jpg
deleted file mode 100644
index 28cac73af8..0000000000
Binary files a/docs/images/erd.jpg and /dev/null differ
diff --git a/docs/images/image (1) (1).png b/docs/images/image (1) (1).png
deleted file mode 100644
index 31e8016c11..0000000000
Binary files a/docs/images/image (1) (1).png and /dev/null differ
diff --git a/docs/images/image (1).png b/docs/images/image (1).png
deleted file mode 100644
index 31e8016c11..0000000000
Binary files a/docs/images/image (1).png and /dev/null differ
diff --git a/docs/images/image (10).png b/docs/images/image (10).png
deleted file mode 100644
index 4bbb1dd805..0000000000
Binary files a/docs/images/image (10).png and /dev/null differ
diff --git a/docs/images/image (100).png b/docs/images/image (100).png
deleted file mode 100644
index 387ffa387b..0000000000
Binary files a/docs/images/image (100).png and /dev/null differ
diff --git a/docs/images/image (101).png b/docs/images/image (101).png
deleted file mode 100644
index da988d6d17..0000000000
Binary files a/docs/images/image (101).png and /dev/null differ
diff --git a/docs/images/image (102).png b/docs/images/image (102).png
deleted file mode 100644
index 97fdb2116b..0000000000
Binary files a/docs/images/image (102).png and /dev/null differ
diff --git a/docs/images/image (103).png b/docs/images/image (103).png
deleted file mode 100644
index 5be9cade9c..0000000000
Binary files a/docs/images/image (103).png and /dev/null differ
diff --git a/docs/images/image (104).png b/docs/images/image (104).png
deleted file mode 100644
index c4ccfeb730..0000000000
Binary files a/docs/images/image (104).png and /dev/null differ
diff --git a/docs/images/image (105).png b/docs/images/image (105).png
deleted file mode 100644
index b2cb7c7c57..0000000000
Binary files a/docs/images/image (105).png and /dev/null differ
diff --git a/docs/images/image (106).png b/docs/images/image (106).png
deleted file mode 100644
index 3e1486fedc..0000000000
Binary files a/docs/images/image (106).png and /dev/null differ
diff --git a/docs/images/image (107).png b/docs/images/image (107).png
deleted file mode 100644
index 65c751565d..0000000000
Binary files a/docs/images/image (107).png and /dev/null differ
diff --git a/docs/images/image (108).png b/docs/images/image (108).png
deleted file mode 100644
index 82286dde98..0000000000
Binary files a/docs/images/image (108).png and /dev/null differ
diff --git a/docs/images/image (109).png b/docs/images/image (109).png
deleted file mode 100644
index 8c438c1ac4..0000000000
Binary files a/docs/images/image (109).png and /dev/null differ
diff --git a/docs/images/image (11).png b/docs/images/image (11).png
deleted file mode 100644
index 8928251cb9..0000000000
Binary files a/docs/images/image (11).png and /dev/null differ
diff --git a/docs/images/image (110).png b/docs/images/image (110).png
deleted file mode 100644
index fe03ab1e12..0000000000
Binary files a/docs/images/image (110).png and /dev/null differ
diff --git a/docs/images/image (111).png b/docs/images/image (111).png
deleted file mode 100644
index 59306a0f45..0000000000
Binary files a/docs/images/image (111).png and /dev/null differ
diff --git a/docs/images/image (112).png b/docs/images/image (112).png
deleted file mode 100644
index 256b93964b..0000000000
Binary files a/docs/images/image (112).png and /dev/null differ
diff --git a/docs/images/image (113).png b/docs/images/image (113).png
deleted file mode 100644
index d167f117a3..0000000000
Binary files a/docs/images/image (113).png and /dev/null differ
diff --git a/docs/images/image (114).png b/docs/images/image (114).png
deleted file mode 100644
index e6020e055d..0000000000
Binary files a/docs/images/image (114).png and /dev/null differ
diff --git a/docs/images/image (115).png b/docs/images/image (115).png
deleted file mode 100644
index 29b13010d0..0000000000
Binary files a/docs/images/image (115).png and /dev/null differ
diff --git a/docs/images/image (116).png b/docs/images/image (116).png
deleted file mode 100644
index fe03ab1e12..0000000000
Binary files a/docs/images/image (116).png and /dev/null differ
diff --git a/docs/images/image (117).png b/docs/images/image (117).png
deleted file mode 100644
index 60c9441b4e..0000000000
Binary files a/docs/images/image (117).png and /dev/null differ
diff --git a/docs/images/image (118).png b/docs/images/image (118).png
deleted file mode 100644
index d91b0929a6..0000000000
Binary files a/docs/images/image (118).png and /dev/null differ
diff --git a/docs/images/image (119).png b/docs/images/image (119).png
deleted file mode 100644
index 215f385be5..0000000000
Binary files a/docs/images/image (119).png and /dev/null differ
diff --git a/docs/images/image (12).png b/docs/images/image (12).png
deleted file mode 100644
index 4bb5ba5ee6..0000000000
Binary files a/docs/images/image (12).png and /dev/null differ
diff --git a/docs/images/image (120).png b/docs/images/image (120).png
deleted file mode 100644
index 76e0f1dbfe..0000000000
Binary files a/docs/images/image (120).png and /dev/null differ
diff --git a/docs/images/image (121).png b/docs/images/image (121).png
deleted file mode 100644
index 9ece87b074..0000000000
Binary files a/docs/images/image (121).png and /dev/null differ
diff --git a/docs/images/image (122).png b/docs/images/image (122).png
deleted file mode 100644
index 8ad004b225..0000000000
Binary files a/docs/images/image (122).png and /dev/null differ
diff --git a/docs/images/image (123).png b/docs/images/image (123).png
deleted file mode 100644
index b04ce35634..0000000000
Binary files a/docs/images/image (123).png and /dev/null differ
diff --git a/docs/images/image (124).png b/docs/images/image (124).png
deleted file mode 100644
index df1f5d47d5..0000000000
Binary files a/docs/images/image (124).png and /dev/null differ
diff --git a/docs/images/image (125).png b/docs/images/image (125).png
deleted file mode 100644
index 275963073e..0000000000
Binary files a/docs/images/image (125).png and /dev/null differ
diff --git a/docs/images/image (126).png b/docs/images/image (126).png
deleted file mode 100644
index 6f8683bb47..0000000000
Binary files a/docs/images/image (126).png and /dev/null differ
diff --git a/docs/images/image (127).png b/docs/images/image (127).png
deleted file mode 100644
index 29972c8d4e..0000000000
Binary files a/docs/images/image (127).png and /dev/null differ
diff --git a/docs/images/image (128).png b/docs/images/image (128).png
deleted file mode 100644
index 6f8683bb47..0000000000
Binary files a/docs/images/image (128).png and /dev/null differ
diff --git a/docs/images/image (129).png b/docs/images/image (129).png
deleted file mode 100644
index b04ce35634..0000000000
Binary files a/docs/images/image (129).png and /dev/null differ
diff --git a/docs/images/image (13).png b/docs/images/image (13).png
deleted file mode 100644
index 30ebd8bac6..0000000000
Binary files a/docs/images/image (13).png and /dev/null differ
diff --git a/docs/images/image (130).png b/docs/images/image (130).png
deleted file mode 100644
index fed3e6bb9a..0000000000
Binary files a/docs/images/image (130).png and /dev/null differ
diff --git a/docs/images/image (131).png b/docs/images/image (131).png
deleted file mode 100644
index 425e635b85..0000000000
Binary files a/docs/images/image (131).png and /dev/null differ
diff --git a/docs/images/image (132).png b/docs/images/image (132).png
deleted file mode 100644
index b6c8916b0b..0000000000
Binary files a/docs/images/image (132).png and /dev/null differ
diff --git a/docs/images/image (14).png b/docs/images/image (14).png
deleted file mode 100644
index 9cc0db8360..0000000000
Binary files a/docs/images/image (14).png and /dev/null differ
diff --git a/docs/images/image (15).png b/docs/images/image (15).png
deleted file mode 100644
index 0405a714c2..0000000000
Binary files a/docs/images/image (15).png and /dev/null differ
diff --git a/docs/images/image (16).png b/docs/images/image (16).png
deleted file mode 100644
index fd851e3545..0000000000
Binary files a/docs/images/image (16).png and /dev/null differ
diff --git a/docs/images/image (17).png b/docs/images/image (17).png
deleted file mode 100644
index 689cd6bc48..0000000000
Binary files a/docs/images/image (17).png and /dev/null differ
diff --git a/docs/images/image (18).png b/docs/images/image (18).png
deleted file mode 100644
index 1165f80180..0000000000
Binary files a/docs/images/image (18).png and /dev/null differ
diff --git a/docs/images/image (19).png b/docs/images/image (19).png
deleted file mode 100644
index 8bba03da47..0000000000
Binary files a/docs/images/image (19).png and /dev/null differ
diff --git a/docs/images/image (2).png b/docs/images/image (2).png
deleted file mode 100644
index a29e6f9919..0000000000
Binary files a/docs/images/image (2).png and /dev/null differ
diff --git a/docs/images/image (20).png b/docs/images/image (20).png
deleted file mode 100644
index 916359ed62..0000000000
Binary files a/docs/images/image (20).png and /dev/null differ
diff --git a/docs/images/image (21).png b/docs/images/image (21).png
deleted file mode 100644
index bb76732a2f..0000000000
Binary files a/docs/images/image (21).png and /dev/null differ
diff --git a/docs/images/image (22).png b/docs/images/image (22).png
deleted file mode 100644
index ac62710a8f..0000000000
Binary files a/docs/images/image (22).png and /dev/null differ
diff --git a/docs/images/image (23).png b/docs/images/image (23).png
deleted file mode 100644
index 87446cd340..0000000000
Binary files a/docs/images/image (23).png and /dev/null differ
diff --git a/docs/images/image (24).png b/docs/images/image (24).png
deleted file mode 100644
index efd6ea7dd0..0000000000
Binary files a/docs/images/image (24).png and /dev/null differ
diff --git a/docs/images/image (25).png b/docs/images/image (25).png
deleted file mode 100644
index d45a7c651a..0000000000
Binary files a/docs/images/image (25).png and /dev/null differ
diff --git a/docs/images/image (26).png b/docs/images/image (26).png
deleted file mode 100644
index ff004ac31e..0000000000
Binary files a/docs/images/image (26).png and /dev/null differ
diff --git a/docs/images/image (27).png b/docs/images/image (27).png
deleted file mode 100644
index a8c322d9ef..0000000000
Binary files a/docs/images/image (27).png and /dev/null differ
diff --git a/docs/images/image (28).png b/docs/images/image (28).png
deleted file mode 100644
index 0ca2f8bf6d..0000000000
Binary files a/docs/images/image (28).png and /dev/null differ
diff --git a/docs/images/image (29).png b/docs/images/image (29).png
deleted file mode 100644
index ed0bfe56e5..0000000000
Binary files a/docs/images/image (29).png and /dev/null differ
diff --git a/docs/images/image (3).png b/docs/images/image (3).png
deleted file mode 100644
index 2a5d77a671..0000000000
Binary files a/docs/images/image (3).png and /dev/null differ
diff --git a/docs/images/image (30).png b/docs/images/image (30).png
deleted file mode 100644
index c23432bc56..0000000000
Binary files a/docs/images/image (30).png and /dev/null differ
diff --git a/docs/images/image (31).png b/docs/images/image (31).png
deleted file mode 100644
index 52da7f379c..0000000000
Binary files a/docs/images/image (31).png and /dev/null differ
diff --git a/docs/images/image (32).png b/docs/images/image (32).png
deleted file mode 100644
index 9313ee0405..0000000000
Binary files a/docs/images/image (32).png and /dev/null differ
diff --git a/docs/images/image (33).png b/docs/images/image (33).png
deleted file mode 100644
index b604600129..0000000000
Binary files a/docs/images/image (33).png and /dev/null differ
diff --git a/docs/images/image (34).png b/docs/images/image (34).png
deleted file mode 100644
index 84d5eeb396..0000000000
Binary files a/docs/images/image (34).png and /dev/null differ
diff --git a/docs/images/image (35).png b/docs/images/image (35).png
deleted file mode 100644
index c647dc193e..0000000000
Binary files a/docs/images/image (35).png and /dev/null differ
diff --git a/docs/images/image (36).png b/docs/images/image (36).png
deleted file mode 100644
index e6bf4cf78c..0000000000
Binary files a/docs/images/image (36).png and /dev/null differ
diff --git a/docs/images/image (37).png b/docs/images/image (37).png
deleted file mode 100644
index 8f38d9f2e0..0000000000
Binary files a/docs/images/image (37).png and /dev/null differ
diff --git a/docs/images/image (38).png b/docs/images/image (38).png
deleted file mode 100644
index 91b42a9b83..0000000000
Binary files a/docs/images/image (38).png and /dev/null differ
diff --git a/docs/images/image (39).png b/docs/images/image (39).png
deleted file mode 100644
index 19a5abb480..0000000000
Binary files a/docs/images/image (39).png and /dev/null differ
diff --git a/docs/images/image (4) (1).png b/docs/images/image (4) (1).png
deleted file mode 100644
index 1044a5eec5..0000000000
Binary files a/docs/images/image (4) (1).png and /dev/null differ
diff --git a/docs/images/image (4).png b/docs/images/image (4).png
deleted file mode 100644
index 1044a5eec5..0000000000
Binary files a/docs/images/image (4).png and /dev/null differ
diff --git a/docs/images/image (40).png b/docs/images/image (40).png
deleted file mode 100644
index 605c3d0001..0000000000
Binary files a/docs/images/image (40).png and /dev/null differ
diff --git a/docs/images/image (41).png b/docs/images/image (41).png
deleted file mode 100644
index a4238057ea..0000000000
Binary files a/docs/images/image (41).png and /dev/null differ
diff --git a/docs/images/image (42).png b/docs/images/image (42).png
deleted file mode 100644
index 006fe194f5..0000000000
Binary files a/docs/images/image (42).png and /dev/null differ
diff --git a/docs/images/image (43).png b/docs/images/image (43).png
deleted file mode 100644
index 99b56af986..0000000000
Binary files a/docs/images/image (43).png and /dev/null differ
diff --git a/docs/images/image (44).png b/docs/images/image (44).png
deleted file mode 100644
index 296f884fbd..0000000000
Binary files a/docs/images/image (44).png and /dev/null differ
diff --git a/docs/images/image (45).png b/docs/images/image (45).png
deleted file mode 100644
index 948ec6dc6a..0000000000
Binary files a/docs/images/image (45).png and /dev/null differ
diff --git a/docs/images/image (46).png b/docs/images/image (46).png
deleted file mode 100644
index 26212a6a0e..0000000000
Binary files a/docs/images/image (46).png and /dev/null differ
diff --git a/docs/images/image (47).png b/docs/images/image (47).png
deleted file mode 100644
index 3e76ebaf9f..0000000000
Binary files a/docs/images/image (47).png and /dev/null differ
diff --git a/docs/images/image (48).png b/docs/images/image (48).png
deleted file mode 100644
index 68284aa020..0000000000
Binary files a/docs/images/image (48).png and /dev/null differ
diff --git a/docs/images/image (49).png b/docs/images/image (49).png
deleted file mode 100644
index d282e9f624..0000000000
Binary files a/docs/images/image (49).png and /dev/null differ
diff --git a/docs/images/image (5).png b/docs/images/image (5).png
deleted file mode 100644
index ad44d9281e..0000000000
Binary files a/docs/images/image (5).png and /dev/null differ
diff --git a/docs/images/image (50).png b/docs/images/image (50).png
deleted file mode 100644
index 6f6ab41e37..0000000000
Binary files a/docs/images/image (50).png and /dev/null differ
diff --git a/docs/images/image (51).png b/docs/images/image (51).png
deleted file mode 100644
index 7a61e0d5ce..0000000000
Binary files a/docs/images/image (51).png and /dev/null differ
diff --git a/docs/images/image (52).png b/docs/images/image (52).png
deleted file mode 100644
index 74a36d60f8..0000000000
Binary files a/docs/images/image (52).png and /dev/null differ
diff --git a/docs/images/image (53).png b/docs/images/image (53).png
deleted file mode 100644
index 1b171d6660..0000000000
Binary files a/docs/images/image (53).png and /dev/null differ
diff --git a/docs/images/image (54).png b/docs/images/image (54).png
deleted file mode 100644
index 02c5f401c7..0000000000
Binary files a/docs/images/image (54).png and /dev/null differ
diff --git a/docs/images/image (55).png b/docs/images/image (55).png
deleted file mode 100644
index 9fcd014e22..0000000000
Binary files a/docs/images/image (55).png and /dev/null differ
diff --git a/docs/images/image (56).png b/docs/images/image (56).png
deleted file mode 100644
index d713c4467e..0000000000
Binary files a/docs/images/image (56).png and /dev/null differ
diff --git a/docs/images/image (57).png b/docs/images/image (57).png
deleted file mode 100644
index 16991c488e..0000000000
Binary files a/docs/images/image (57).png and /dev/null differ
diff --git a/docs/images/image (58).png b/docs/images/image (58).png
deleted file mode 100644
index da5651e101..0000000000
Binary files a/docs/images/image (58).png and /dev/null differ
diff --git a/docs/images/image (59).png b/docs/images/image (59).png
deleted file mode 100644
index 24686d3eb5..0000000000
Binary files a/docs/images/image (59).png and /dev/null differ
diff --git a/docs/images/image (6).png b/docs/images/image (6).png
deleted file mode 100644
index 1e7f6dae78..0000000000
Binary files a/docs/images/image (6).png and /dev/null differ
diff --git a/docs/images/image (60).png b/docs/images/image (60).png
deleted file mode 100644
index 29f423634e..0000000000
Binary files a/docs/images/image (60).png and /dev/null differ
diff --git a/docs/images/image (61).png b/docs/images/image (61).png
deleted file mode 100644
index 7862ee625b..0000000000
Binary files a/docs/images/image (61).png and /dev/null differ
diff --git a/docs/images/image (62).png b/docs/images/image (62).png
deleted file mode 100644
index b3e239f2b6..0000000000
Binary files a/docs/images/image (62).png and /dev/null differ
diff --git a/docs/images/image (63).png b/docs/images/image (63).png
deleted file mode 100644
index 828f087f61..0000000000
Binary files a/docs/images/image (63).png and /dev/null differ
diff --git a/docs/images/image (64).png b/docs/images/image (64).png
deleted file mode 100644
index 36fe2a1e35..0000000000
Binary files a/docs/images/image (64).png and /dev/null differ
diff --git a/docs/images/image (65).png b/docs/images/image (65).png
deleted file mode 100644
index 572bbda9cc..0000000000
Binary files a/docs/images/image (65).png and /dev/null differ
diff --git a/docs/images/image (66).png b/docs/images/image (66).png
deleted file mode 100644
index acf382d839..0000000000
Binary files a/docs/images/image (66).png and /dev/null differ
diff --git a/docs/images/image (67).png b/docs/images/image (67).png
deleted file mode 100644
index dd933bf948..0000000000
Binary files a/docs/images/image (67).png and /dev/null differ
diff --git a/docs/images/image (68).png b/docs/images/image (68).png
deleted file mode 100644
index cd7ac56013..0000000000
Binary files a/docs/images/image (68).png and /dev/null differ
diff --git a/docs/images/image (69).png b/docs/images/image (69).png
deleted file mode 100644
index 832fdca57b..0000000000
Binary files a/docs/images/image (69).png and /dev/null differ
diff --git a/docs/images/image (7).png b/docs/images/image (7).png
deleted file mode 100644
index 3db41ec3cf..0000000000
Binary files a/docs/images/image (7).png and /dev/null differ
diff --git a/docs/images/image (70).png b/docs/images/image (70).png
deleted file mode 100644
index 1d89c9e623..0000000000
Binary files a/docs/images/image (70).png and /dev/null differ
diff --git a/docs/images/image (71).png b/docs/images/image (71).png
deleted file mode 100644
index 13a8bc6e0c..0000000000
Binary files a/docs/images/image (71).png and /dev/null differ
diff --git a/docs/images/image (72).png b/docs/images/image (72).png
deleted file mode 100644
index a982882406..0000000000
Binary files a/docs/images/image (72).png and /dev/null differ
diff --git a/docs/images/image (73).png b/docs/images/image (73).png
deleted file mode 100644
index fa975186e6..0000000000
Binary files a/docs/images/image (73).png and /dev/null differ
diff --git a/docs/images/image (74).png b/docs/images/image (74).png
deleted file mode 100644
index 13837a1fc5..0000000000
Binary files a/docs/images/image (74).png and /dev/null differ
diff --git a/docs/images/image (75).png b/docs/images/image (75).png
deleted file mode 100644
index f1a876c9c2..0000000000
Binary files a/docs/images/image (75).png and /dev/null differ
diff --git a/docs/images/image (76).png b/docs/images/image (76).png
deleted file mode 100644
index 69f2e45d27..0000000000
Binary files a/docs/images/image (76).png and /dev/null differ
diff --git a/docs/images/image (77).png b/docs/images/image (77).png
deleted file mode 100644
index 31f1c50bc4..0000000000
Binary files a/docs/images/image (77).png and /dev/null differ
diff --git a/docs/images/image (78).png b/docs/images/image (78).png
deleted file mode 100644
index a778074668..0000000000
Binary files a/docs/images/image (78).png and /dev/null differ
diff --git a/docs/images/image (79).png b/docs/images/image (79).png
deleted file mode 100644
index b610497418..0000000000
Binary files a/docs/images/image (79).png and /dev/null differ
diff --git a/docs/images/image (8).png b/docs/images/image (8).png
deleted file mode 100644
index 369176772b..0000000000
Binary files a/docs/images/image (8).png and /dev/null differ
diff --git a/docs/images/image (80).png b/docs/images/image (80).png
deleted file mode 100644
index 3fa7b3dbca..0000000000
Binary files a/docs/images/image (80).png and /dev/null differ
diff --git a/docs/images/image (81).png b/docs/images/image (81).png
deleted file mode 100644
index 6ed47b5b43..0000000000
Binary files a/docs/images/image (81).png and /dev/null differ
diff --git a/docs/images/image (82).png b/docs/images/image (82).png
deleted file mode 100644
index 875afd80c7..0000000000
Binary files a/docs/images/image (82).png and /dev/null differ
diff --git a/docs/images/image (83).png b/docs/images/image (83).png
deleted file mode 100644
index f8bddabbc6..0000000000
Binary files a/docs/images/image (83).png and /dev/null differ
diff --git a/docs/images/image (84).png b/docs/images/image (84).png
deleted file mode 100644
index feab9b6c44..0000000000
Binary files a/docs/images/image (84).png and /dev/null differ
diff --git a/docs/images/image (85).png b/docs/images/image (85).png
deleted file mode 100644
index 4f03672572..0000000000
Binary files a/docs/images/image (85).png and /dev/null differ
diff --git a/docs/images/image (86).png b/docs/images/image (86).png
deleted file mode 100644
index 38d2c509b2..0000000000
Binary files a/docs/images/image (86).png and /dev/null differ
diff --git a/docs/images/image (87).png b/docs/images/image (87).png
deleted file mode 100644
index 983e3d7966..0000000000
Binary files a/docs/images/image (87).png and /dev/null differ
diff --git a/docs/images/image (88).png b/docs/images/image (88).png
deleted file mode 100644
index 0c8ff0481a..0000000000
Binary files a/docs/images/image (88).png and /dev/null differ
diff --git a/docs/images/image (89).png b/docs/images/image (89).png
deleted file mode 100644
index a5774adb2b..0000000000
Binary files a/docs/images/image (89).png and /dev/null differ
diff --git a/docs/images/image (9).png b/docs/images/image (9).png
deleted file mode 100644
index 37959e4158..0000000000
Binary files a/docs/images/image (9).png and /dev/null differ
diff --git a/docs/images/image (90).png b/docs/images/image (90).png
deleted file mode 100644
index 77e11a5ad7..0000000000
Binary files a/docs/images/image (90).png and /dev/null differ
diff --git a/docs/images/image (91).png b/docs/images/image (91).png
deleted file mode 100644
index dfd7a96494..0000000000
Binary files a/docs/images/image (91).png and /dev/null differ
diff --git a/docs/images/image (92).png b/docs/images/image (92).png
deleted file mode 100644
index e7f14fb486..0000000000
Binary files a/docs/images/image (92).png and /dev/null differ
diff --git a/docs/images/image (93).png b/docs/images/image (93).png
deleted file mode 100644
index 171ad5b8fb..0000000000
Binary files a/docs/images/image (93).png and /dev/null differ
diff --git a/docs/images/image (94).png b/docs/images/image (94).png
deleted file mode 100644
index 8150b78498..0000000000
Binary files a/docs/images/image (94).png and /dev/null differ
diff --git a/docs/images/image (95).png b/docs/images/image (95).png
deleted file mode 100644
index 505f939c61..0000000000
Binary files a/docs/images/image (95).png and /dev/null differ
diff --git a/docs/images/image (96).png b/docs/images/image (96).png
deleted file mode 100644
index cb6bc4a53b..0000000000
Binary files a/docs/images/image (96).png and /dev/null differ
diff --git a/docs/images/image (97).png b/docs/images/image (97).png
deleted file mode 100644
index 8195f5aa6d..0000000000
Binary files a/docs/images/image (97).png and /dev/null differ
diff --git a/docs/images/image (98).png b/docs/images/image (98).png
deleted file mode 100644
index 554ca75e28..0000000000
Binary files a/docs/images/image (98).png and /dev/null differ
diff --git a/docs/images/image (99).png b/docs/images/image (99).png
deleted file mode 100644
index 8fb9f6c561..0000000000
Binary files a/docs/images/image (99).png and /dev/null differ
diff --git a/docs/images/image.png b/docs/images/image.png
deleted file mode 100644
index 58b038316d..0000000000
Binary files a/docs/images/image.png and /dev/null differ
diff --git a/docs/images/image2 (1).png b/docs/images/image2 (1).png
deleted file mode 100644
index 167e45a876..0000000000
Binary files a/docs/images/image2 (1).png and /dev/null differ
diff --git a/docs/images/image2 (2).png b/docs/images/image2 (2).png
deleted file mode 100644
index 11e6981fdd..0000000000
Binary files a/docs/images/image2 (2).png and /dev/null differ
diff --git a/docs/images/image2 (3).png b/docs/images/image2 (3).png
deleted file mode 100644
index 2956744c6f..0000000000
Binary files a/docs/images/image2 (3).png and /dev/null differ
diff --git a/docs/images/image2 (4).png b/docs/images/image2 (4).png
deleted file mode 100644
index f309468db4..0000000000
Binary files a/docs/images/image2 (4).png and /dev/null differ
diff --git a/docs/images/image2 (5).png b/docs/images/image2 (5).png
deleted file mode 100644
index 5650702ddd..0000000000
Binary files a/docs/images/image2 (5).png and /dev/null differ
diff --git a/docs/images/image2.png b/docs/images/image2.png
deleted file mode 100644
index 7b5e50674d..0000000000
Binary files a/docs/images/image2.png and /dev/null differ
diff --git a/docs/images/linkedin_cover_profile-2x.png b/docs/images/linkedin_cover_profile-2x.png
deleted file mode 100644
index 03ad2efc4c..0000000000
Binary files a/docs/images/linkedin_cover_profile-2x.png and /dev/null differ
diff --git a/docs/images/platform_api_diagram.jpg b/docs/images/platform_api_diagram.jpg
deleted file mode 100644
index eecb8d1b5b..0000000000
Binary files a/docs/images/platform_api_diagram.jpg and /dev/null differ
diff --git a/docs/images/prod1 (1).png b/docs/images/prod1 (1).png
deleted file mode 100644
index 7837338082..0000000000
Binary files a/docs/images/prod1 (1).png and /dev/null differ
diff --git a/docs/images/prod1.png b/docs/images/prod1.png
deleted file mode 100644
index 7837338082..0000000000
Binary files a/docs/images/prod1.png and /dev/null differ
diff --git a/docs/images/screenshot-2021-09-14-at-22.45.58.png b/docs/images/screenshot-2021-09-14-at-22.45.58.png
deleted file mode 100644
index b208054301..0000000000
Binary files a/docs/images/screenshot-2021-09-14-at-22.45.58.png and /dev/null differ
diff --git a/docs/images/screenshot-2021-10-05-at-11.19.20.png b/docs/images/screenshot-2021-10-05-at-11.19.20.png
deleted file mode 100644
index 90d3e43757..0000000000
Binary files a/docs/images/screenshot-2021-10-05-at-11.19.20.png and /dev/null differ
diff --git a/docs/images/spark_solutions_logo.png b/docs/images/spark_solutions_logo.png
deleted file mode 100644
index 7f872c7d39..0000000000
Binary files a/docs/images/spark_solutions_logo.png and /dev/null differ
diff --git a/docs/images/spree_commerce_home_header_2-2x-1-.png b/docs/images/spree_commerce_home_header_2-2x-1-.png
deleted file mode 100644
index ce942b9e70..0000000000
Binary files a/docs/images/spree_commerce_home_header_2-2x-1-.png and /dev/null differ
diff --git a/docs/images/spree_commerce_home_header_2-2x.png b/docs/images/spree_commerce_home_header_2-2x.png
deleted file mode 100644
index efe3b26291..0000000000
Binary files a/docs/images/spree_commerce_home_header_2-2x.png and /dev/null differ
diff --git a/docs/images/spree_commerce_spree_api_3-2x.png b/docs/images/spree_commerce_spree_api_3-2x.png
deleted file mode 100644
index 204a896c28..0000000000
Binary files a/docs/images/spree_commerce_spree_api_3-2x.png and /dev/null differ
diff --git a/docs/images/spree_commerce_spree_api_6.png b/docs/images/spree_commerce_spree_api_6.png
deleted file mode 100644
index e67fc26243..0000000000
Binary files a/docs/images/spree_commerce_spree_api_6.png and /dev/null differ
diff --git a/docs/images/spree_header_978-2x.png b/docs/images/spree_header_978-2x.png
deleted file mode 100644
index 67f3aa7de9..0000000000
Binary files a/docs/images/spree_header_978-2x.png and /dev/null differ
diff --git a/docs/images/starter_template.png b/docs/images/starter_template.png
deleted file mode 100644
index d88e315948..0000000000
Binary files a/docs/images/starter_template.png and /dev/null differ
diff --git a/docs/images/zrzut-ekranu-2021-08-19-135155.jpg b/docs/images/zrzut-ekranu-2021-08-19-135155.jpg
deleted file mode 100644
index 4be1e11561..0000000000
Binary files a/docs/images/zrzut-ekranu-2021-08-19-135155.jpg and /dev/null differ
diff --git a/docs/images/zrzut-ekranu-2021-08-19-161951.jpg b/docs/images/zrzut-ekranu-2021-08-19-161951.jpg
deleted file mode 100644
index 2f16d52d5d..0000000000
Binary files a/docs/images/zrzut-ekranu-2021-08-19-161951.jpg and /dev/null differ
diff --git a/docs/images/zrzut-ekranu-2021-08-19-162218.jpg b/docs/images/zrzut-ekranu-2021-08-19-162218.jpg
deleted file mode 100644
index e821ed5e62..0000000000
Binary files a/docs/images/zrzut-ekranu-2021-08-19-162218.jpg and /dev/null differ
diff --git a/docs/images/zrzut-ekranu-2021-08-20-000659.jpg b/docs/images/zrzut-ekranu-2021-08-20-000659.jpg
deleted file mode 100644
index 877d342027..0000000000
Binary files a/docs/images/zrzut-ekranu-2021-08-20-000659.jpg and /dev/null differ
diff --git a/docs/images/zrzut-ekranu-2021-08-20-001032.jpg b/docs/images/zrzut-ekranu-2021-08-20-001032.jpg
deleted file mode 100644
index 6284f36edb..0000000000
Binary files a/docs/images/zrzut-ekranu-2021-08-20-001032.jpg and /dev/null differ
diff --git a/sample/db/samples.rb b/sample/db/samples.rb
index 3a739393bf..e6ad2d039f 100644
--- a/sample/db/samples.rb
+++ b/sample/db/samples.rb
@@ -1 +1,2 @@
Spree::Sample.load_sample('payment_methods')
+Spree::Sample.load_sample('posts')
diff --git a/sample/db/samples/posts.rb b/sample/db/samples/posts.rb
new file mode 100644
index 0000000000..5abe9255cf
--- /dev/null
+++ b/sample/db/samples/posts.rb
@@ -0,0 +1,8 @@
+store = Spree::Store.default
+
+store.posts.create!(
+ title: 'Hello World',
+ content: 'This is a test post',
+ published_at: Time.current,
+ author: store.admin_users.first,
+)
diff --git a/sample/db/samples/stock.rb b/sample/db/samples/stock.rb
index ccd71b054d..8aec79d670 100644
--- a/sample/db/samples/stock.rb
+++ b/sample/db/samples/stock.rb
@@ -1,7 +1,7 @@
Spree::Sample.load_sample('variants')
country = Spree::Country.find_by(iso: 'US')
-location = Spree::StockLocation.find_or_create_by!(name: 'default', propagate_all_variants: false)
+location = Spree::StockLocation.find_or_create_by!(name: Spree.t(:default_stock_location_name), propagate_all_variants: false)
location.update(
address1: 'Example Street',
city: 'City',
diff --git a/sample/lib/spree_sample.rb b/sample/lib/spree_sample.rb
index 0d70b2c580..2112a308bd 100644
--- a/sample/lib/spree_sample.rb
+++ b/sample/lib/spree_sample.rb
@@ -29,6 +29,8 @@ module SpreeSample
Spree::Sample.load_sample('payments')
Spree::Sample.load_sample('reimbursements')
Spree::Sample.load_sample('return_authorization_reasons')
+
+ Spree::Sample.load_sample('posts')
end
end
end
diff --git a/storefront/app/views/themes/default/spree/page_sections/_post_grid.html.erb b/storefront/app/views/themes/default/spree/page_sections/_post_grid.html.erb
index 837ace39ea..f338cb843e 100644
--- a/storefront/app/views/themes/default/spree/page_sections/_post_grid.html.erb
+++ b/storefront/app/views/themes/default/spree/page_sections/_post_grid.html.erb
@@ -1,11 +1,11 @@
<div style="<%= section_styles(section) %>">
<% if @posts.any? %>
<div class="page-container">
- <%= turbo_frame_tag :posts, class: 'flex flex-col' do %>
- <%= render partial: 'spree/posts/post', collection: @posts %>
- <% end %>
+ <div class="grid grid-cols-1 md:grid-cols-3 gap-8 mb-4 auto-rows-fr">
+ <%= render partial: 'spree/posts/post', collection: @posts, cached: true %>
+ </div>
- <%= render 'spree/posts/pagination' %>
+ <%= paginate @posts, theme: 'storefront', outer_window: 1, inner_window: 2 %>
</div>
<% end %>
</div>
diff --git a/storefront/app/views/themes/default/spree/posts/_post.html.erb b/storefront/app/views/themes/default/spree/posts/_post.html.erb
index f0da5a2ddb..50cc685366 100644
--- a/storefront/app/views/themes/default/spree/posts/_post.html.erb
+++ b/storefront/app/views/themes/default/spree/posts/_post.html.erb
@@ -1,8 +1,10 @@
-<div class="flex flex-col max-w-3xl m-auto mt-16 first:mt-0">
- <%= link_to spree.post_path(post), data: { turbo_frame: '_top' } do %>
- <% if post.image.attached? && post.image.variable? %>
- <%= image_tag main_app.cdn_image_url(post.image.variant(spree_image_variant_options(resize_to_fit: [nil, 800]))), height: 400, class: 'h-full w-full object-cover object-center', loading: :lazy, alt: post.title %>
- <% end %>
+<div id="<%= dom_id(post) %>">
+ <%= link_to spree.post_path(post), class: 'block hover:opacity-70 transition-opacity' do %>
+ <div class="h-[200px] w-full bg-gray-100">
+ <% if post.image.attached? && post.image.variable? %>
+ <%= image_tag main_app.cdn_image_url(post.image.variant(spree_image_variant_options(resize_to_fit: [nil, 800]))), height: 400, class: 'h-full w-full object-cover object-center', loading: :lazy, alt: post.title %>
+ <% end %>
+ </div>
<h1 class="uppercase text-lg font-medium mt-4"><%= post.title %></h1>
<div class="mt-2 text-sm"><%= local_time(post.published_at, '%B %e, %Y') %></div>