Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spree/spree_starter
@spree application starter template
https://github.com/spree/spree_starter
commerce ecommerce rails spree
Last synced: 3 days ago
JSON representation
@spree application starter template
- Host: GitHub
- URL: https://github.com/spree/spree_starter
- Owner: spree
- License: bsd-3-clause
- Created: 2015-11-01T19:47:09.000Z (about 9 years ago)
- Default Branch: main
- Last Pushed: 2024-05-28T16:13:23.000Z (8 months ago)
- Last Synced: 2024-05-29T07:21:46.112Z (8 months ago)
- Topics: commerce, ecommerce, rails, spree
- Language: Ruby
- Homepage: https://spreecommerce.org
- Size: 4.49 MB
- Stars: 352
- Watchers: 28
- Forks: 168
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Spree Starter
This is a starter kit for [Spree Commerce](https://spreecommerce.org) - the open-source e-commerce platform for Rails. It is a great starting point for any Rails developer to quickly build an e-commerce store.
This starter uses:
* Spree Commerce 4.8 which includes Admin Dashboard, API and Storefront
* Ruby 3.3 and Ruby on Rails 7.1
* Solid Queue with Mission Control UI (access only to Spree admins) for background jobs
* Solid Cache for excellent caching and performance
You don't need to install any additional tools or libraries to start developing with Spree Starter. Everything is already set up for you.
## Installation
Make sure you have the following installed:
* Docker with Docker Compose - [installation instructions](https://docs.docker.com/get-docker/)
* Ruby 3.3 - [installation instructions](https://www.ruby-lang.org/en/documentation/installation/)
* Vips - [installation instructions](https://libvips.github.io/libvips/install.html)
```bash
bin/setup
```
If you want to use sample data (products, categories), you can load it using the following command:
```bash
bin/rake spree_sample:load
```
#### Full docker setup
If you're having trouble with Ruby/etc setup and just want to get everything up and running, you can use the following command to start the docker containers.
```bash
docker pull vendoconnect/spree_starter
docker run -p 3000:3000 vendoconnect/spree_starter
```
This will start the docker containers and automatically start the rails server.
To sign in into the admin dashboard go to `https://localhost:3000/admin` and use the following credentials:
```bash
Email: [email protected]
Password: spree123
```
### Switching to PostgreSQL
```bash
bin/rails db:system:change --to=postgresql
```
### Switching to MySQL
By default, Spree Starter uses PostgreSQL. If you want to switch to MySQL, you can do so by running the following command:
```bash
bin/rails db:system:change --to=mysql
```
You will also need to run `bin/setup` again to install the MySQL adapter and create the database.
### Launch local server
```bash
bin/rails s
```
## Deployment
### Using Render
Note that sample data does not automatically get loaded when deploying to Render with the default configuration. In order to add sample data, run the following commands in the web service shell:
```bash
bin/rake spree_sample:load
```
### Using Heroku
[](https://heroku.com/deploy)
### Other platforms
Spree Starter is a standard Rails application, so you can deploy it to any platform that supports Ruby on Rails applications. You can also use Docker to deploy it to any container-based platform. Please check [Spree Guides](https://guides.spreecommerce.org/developer/deployment.html) for more information.
## Troubleshooting
### libvips error
If you encounter an error like the following:
```bash
LoadError: Could not open library 'vips.so.42'
```
Please check that libvips is installed with `vips -v`, and if it is not installed, follow [installation instructions here](https://www.libvips.org/install.html).