Medusa nedir ? İlk proje kurulumu nasıl gerçekleştirilir ?

Kadriye Aksakal
3 min readJan 15, 2025

--

Medusa logo

Herkese merhabalar 👋🏻 bu yazımda sizlere yeni öğrenmeye başladığım ve öğrendikçe de sizlerle paylaşacağım yeni araştırma konum olan Medusa’dan bahsedeceğim. Umarım sizler için hem faydalı hem de keyifli bir içerik olur. Vakit kaybetmeden başlayalım.

Medusa nedir ?

Medusa açık kaynak kodlu bir e-ticaret sitesi geliştirme platformudur. Medusa’nın ilk kurulumu ile gelen proje yapısı temel alınarak üzerinde geliştirme yapılabilmektedir. Shopify alternatifi olarak öne çıkmaktadır. GitHub üzerinde 27.1K kullanıcı tarafından yıldızlanan, halen gelişimini sürdüren ve geniş bir discord topluluğu tarafından da desteklenen bir projedir. Şu an aktif olarak V2.2.0 versiyonu kullanılmaktadır.

Kısa sürede mağaza kurulumunu gerçekleştirip, geliştirme yapabilmenizi sağlayan Medusa birçok uygulama ile de kolaylıkla entegre edilebilmektedir. Bunlardan bazıları bildirim servisi ile kullanabileceğiniz Slack ve ödeme yöntemlerinden biri olan Paypal. Bu örnekleri daha da çoğaltabiliriz bunun için Medusa Plugins sayfasına göz atabilirsiniz.

Medusa’dan kısaca bahsettiğimize göre proje geliştirmeden önce bir proje geliştirmemiz için gerekli olan ortam bilgilerinden bahsedelim. Medusa’da geliştirme yapabilmemiz için öncelikle Node.js, Git CLI Tool ve PostgreSQL’i ortamınıza kurmamız gerekmektedir. Node.js ve Git CLI Tool tamam ama PostgreSQL’i neden kuruyoruz diye aklınıza takılmış olabilir. Medusa ile proje oluştururken otomatik olarak bizim için bir veri tabanı da oluşturuyor. Bu sayede mağazamız için eklediğimiz her şey veri tabanına otomatik olarak kayıt oluyor. Ortam için gerekli kurumları bu şekilde gerçekleştirebilirsiniz. Daha detaylı bilgi için Medusa’nın kurulum sayfasına göz atabilirsiniz.

İlk proje kurulumu nasıl gerçekleştirilir ?

Medusa’nın ne olduğunu öğrendik. Geliştirme ortamını da oluşturduğumuza göre sıra ilk projemizi geliştirmeye geldi. O zaman kurulumu ile başlayalım. Terminale şu komutu yazarak projenizi oluşturabilirsiniz.

npx create-medusa-app@latest [project_name]

Projenizi hangi isimle kurmak istiyorsanız yazıp enter tuşuna basıyoruz. Daha sonra karşımıza Storefront isteyip istemediğimizle sorusu geliyor.

Next.js storefront oluşturma seçeneği soruluyor.

Storefront kurulmasına Y derseniz Medusa otomatik olarak sizlere Next.js ile geliştirme yapabileceğiniz bir arayüz de kuruyor. Yani şöyle Medusa ile admin panel kurarken storefront ile de sizlere mağazayı kullanıcılara sunabileceğiniz bir arayüz kuruyor. Buna N diyerek daha sonra kendiniz de kurabilirsiniz. Ben Y diyerek devam ediyorum. Daha sonra kurulum başlıyor.

Tüm dosyalar kuruluyor.

Önce proje dosyalarını kuruyor. Daha sonra Next.js ile geliştireceğimiz storefront dosyalarını son olarak da veri tabanı oluşturuluyor. Veri tabanının başarılı bir şekilde oluşturulup oluşturulmadığını da pgAdmin ile görüntüleyebilirsiniz. Databases altına otomatik olarak oluşturulmuş aşağıdaki görselde gördüğünüz gibi.

PostgreSQL / Databases

Kurulum başarılı bir şekilde sağlandıktan sonra projemiz otomatik olarak ayağa kaldırılacaktır.

Admin panel / Kayıt ol sayfası

Görmüş olduğunuz admin panel arayüzüdür. Hesap oluşturarak daha sonra panele giriş yapabilirsiniz. Bundan bir sonraki yazımda daha detaylı bahsedeceğim.

Şimdi admin paneli görüyoruz bir de storefront projesi kurmuştuk onu da ayağa kaldıralım. Öncelikle proje dizinimize geliyoruz. Projeyi ilk defa ayağa kaldırmadan önce bir kez build etmemiz gerekmektedir.

npx run build

Proje build olup dosyaları otomatik olarak güncelledikten sonra artık geliştirme yapmak için çalıştırabiliriz. Bunun için aşağıdaki komutu çalıştırmanız yeterli.

npx run dev

Komut başarılı bir şekilde çalıştıktan sonra admin panel ile eklediğimiz içerikleri görüntüleyebileceğiniz bir arayüz sizleri karşılıyor olacak.

Medusa store

Evet artık projeniz geliştirilmeye hazır hale geldi. Bu yazımla sizlere kısaca Medusa’nın ne olduğunu, geliştirme yapmak için nelere ihtiyaç duyduğumuzu ve ilk proje kurulumundan bahsettim. Serinin bir sonraki yazısında görüşmek üzere.

Soru, görüş ve önerileriniz için benimle iletişime geçebilirsiniz. Keyifli okumalar dilerim.

--

--

Responses (1)