ittttori01 / litecart Goto Github PK

Litecart is an open source shopping-cart in 1 file of embedded database (SQLite), convenient dashboard UI and simple site.

⚠️  Current major version is zero (v0.x.x) to accommodate rapid development and fast iteration while getting early feedback from users. Please keep in mind that litecart is still under active development and therefore full backward compatibility is not guaranteed before reaching v1.0.0.

• 🚀 Simple and fast one-click installation
• 💰 Support for popular payment systems
• 🔑 Support for selling both files and license keys
• ⚙️ Uses SQLite instead of heavy databases like Mysql, Postgresql, MongoDB
• ☁️ Lightweight website that can be easily modified
• 🧞‍♂️Convenient administration panel
• ⚡️ Works on any hardware, server
• 🔒 Built-in support for HTTPS

litecart is engineered for easy installation and operation, requiring just a single command from your terminal. Besides the conventional installation method, litecart can also be set up and operated via HomeBrew, Docker, or any other container orchestration tools like Docker Compose, Docker Swarm, Rancher, or Kubernetes.

The fastest method to install litecart on macOS involves using Homebrew. This will install the command-line tools and the litecart server as a combined executable. If you don't utilize Homebrew, adhere to the Linux instructions below for litecart installation.

brew install shurco/tap/litecart

Alternately, you can configure the tap and install the package separately:

$ brew tap shurco/tap
$ brew install litecart

The most straightforward and recommended method to start using litecart on Unix operating systems involves installing and utilizing the litecart command-line tool. Execute the given command in your terminal and adhere to the instructions displayed on the screen.

curl -L https://raw.githubusercontent.com/shurco/litecart/main/scripts/install | sh

The simplest and most recommended method to start using litecart on Windows is by installing and utilizing the litecart command-line tool. Execute the given command in your terminal and adhere to the instructions displayed on the screen.

curl -L https://raw.githubusercontent.com/shurco/litecart/main/scripts/install | sh

or download and unzip the latest version for Windows.

Docker enables the management and operation of a Litecart instance without requiring the installation of any command-line tools. The Litecart Docker container includes all necessary command-line tools or even for server execution.

docker run \
  --name litecart \
  --restart unless-stopped \
  -p '8080:8080' \
  -v ./lc_base:./lc_base \
  -v ./lc_digitals:./lc_digitals \
  -v ./lc_uploads:./lc_uploads \
  shurco/litecart:latest

or

docker run \
  --name litecart \
  --restart unless-stopped \
  -p '8080:8080' \
  -v ./lc_base:./lc_base \
  -v ./lc_digitals:./lc_digitals \
  -v ./lc_uploads:./lc_uploads \
  ghcr.io/shurco/litecart:latest

Getting started with litecart is as easy as starting up the litecart server

Default run for Linux/macOS:

./litecart serve

For Windows:

litecart.exe serve

When launched for the first time, necessary folders will be created in the directory with the executable file. The default links for access are:

• http://localhost:8080 - website
• http://localhost:8080/_/ - control panel

If you need to run on a different port, use the flag --http:

./litecart serve --http 0.0.0.0:8088

⚠️   Ports <= 1024 are privileged ports. You can't use them unless you're root or have the explicit permission to use them. See this answer for an explanation or wikipedia or something you trust more. Use: sudo setcap 'cap_net_bind_service=+ep' /path_to/litecart

Usage:

./litecart [command] [flags]

Available commands:

init        Creating the basic structure
migrate     Migrate on the latest version of database schema
serve       Starts the web server (default to 0.0.0.0:8080)
update      Updating the application to the latest version

Global flags ./litecart [flags]:

-h, --help      help for litecart
-v, --version   version for litecart

Serve flags ./litecart serve [flags]:

--http string    server address (default "0.0.0.0:8080")
--https string   https server address (auto TLS)
--no-site        disable create site

• Product in the form of files
• Product in the form of license keys
• Product returned via API to another site (example license keys)
• Payment Stripe
• Payment PayPal
• Payment Square
• Payment Adyen
• Payment Checkout
• Support for payment using crypto
• Support WebHook

If you want to say thank you and/or support the active development of litecart:

1. Add a GitHub Star to the project.
2. Tweet about the project on your Twitter.
3. Write a review or tutorial on Medium, Dev.to or personal blog.
4. Support the project by donating a cup of coffee.

You can learn more about how you can contribute to this project in the contribution guide.