Skip to content

shopyo/shopyo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1,420 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation


shopyo

Downloads Codecov Tests PyPI version shields.io Documentation Status CII Best Practices OpenSSF Scorecard

Featured on Weekly Python issue 436 🌟

A 45 mins talk was dedicated to it at EuroPython 🌟

Must watch: Shopyo: Your Mega Flask Machine (short vid)

E-commerce modules transferred to ShopCube

[ DOCS | DISCORD | CONTRIBUTE | TWITTER]

What?

Your next-level modular web framework. Get organisation & scalability from day 1.

Built on top of Flask, it offers most Django features, sometimes a tidbit more with far more flexibility.

Why?

Perk
πŸ₯ No learning Does not get into the way, uses common flask-packages. You only need to know Flask.
πŸ—οΈ Architecture Never think about architecture of your app, just build & integrate extensions.
🏒 Scalable As your app grows, Shopyo caters for your codebase with powerful features.
πŸ₯’ Good practices Testing, docs etc are covered. Don't make those afterthoughts.
πŸ”§ Ease your life We've been there. Awesome utils to ease development.
πŸͺœ Scaffolding Don't waste time writing boilerplate code. We've got you covered.
πŸ–οΈ Theming system You need theme in your apps? We integrate a default theme system.

Features

  • βš›οΈ i18n setup
  • πŸ” Login & Auth
  • πŸ“§ Email
  • πŸ“¦ 2-level modularity
  • πŸͺ Designed for really BIG apps
  • πŸŒ… Assets management

Quick start

pip install shopyo
shopyo new blog
cd blog
shopyo initialise
flask run --debug

Note: You can also run shopyo new (without a project name) inside an existing directory to scaffold Shopyo in place.

Go to http://127.0.0.1:5000/dashboard with credentials [email protected] / pass.

Why Shopyo?

  • Flat Structure: No more nested proj/proj confusion.
  • Zero-Friction Assets: Use standard Flask url_for('static', filename='modules/...'). It just works in Dev and Prod.
  • Auto-Discovery: Modules are detected and registered automatically.

  • Not framework docs but docs for the project you are building.

First time contributing?

We have a 100% first-timers friendly policy. Check out the testimonials.

Thank you! One of the best onboarding experiences I've had. Learned a lot too (Ramon from Codesee.io)

Glimpse

Who uses Shopyo?

site name description
Maurilearn.com Elearning platform
Linkolearn.com Learn By links
FlaskCon.com Conference soft

Big??

Powered by apps / modules. Add as many as you like.

Apps are not enough, organise them in boxes and get the ultimate order you need.

You need a customised Django? This is the project. You need to build an ERP? This is the project.

Linux??

Hackable to the core. Even the dashboard is but a module.

Don't need our modules? Nuke them. Look boring? modify them

Reliable?

We don't maintain middlewares. We rely on battle tested batteries like:

  • flask_sqlalchemy
  • flask_login & co

Heck remove them if you don't want. Want to use Peewee? You can.

Rich Flask API

Common flask patterns are integrated, the structure is over the moon.

Common flask tasks are provided with an API: custom notifications, bulk form errors

Back office feel & Theme

All looks are 100% customisable with themes ~ Backend, bootstrap included by default.

Again blow it up & use what you want. It's possible

Transparent: Code your own web distro

Everything is clear, not hidden. You can 100% customise whatever you want.

We did not hardcode our choices. Our APIS are incremental. You can always use barebones.

Plug & Play

The modules are put by copy paste. No blueprint codes to write.

Contribute

We follow a 100% first-timers friendly policy.

πŸ‘‰ Get started here

πŸ‘‰ Join the Discord, ask questions & learn about Flask tricks during our dev talks!

πŸ“š Docs

πŸ‘‰ Link: shopyo.readthedocs.io/

πŸ“ž Contact (inlcuding in case of vulns)

Support team if you are stuck

About

The package for big, scalable and modular Flask apps. More than just Flask boilerplate

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Contributors

Languages