Başlarken

Genel Bakış

Silgi, modern mikroservis mimarileri için geliştirilmiş, güçlü ve tip güvenli bir TypeScript framework'üdür. Uçtan uca tip güvenliği sağlar, geliştirici deneyimini ve sürdürülebilirliği ön planda tutar. Silgi ile ölçeklenebilir, bakımı kolay ve güvenilir backend servisleri oluşturmak çok daha kolaydır.

Silgi'nin temel bileşenleri:

• silgi.config.ts: Projenizin tüm yapılandırmasını ve modüllerini yönettiğiniz ana dosya.
• Geliştirme Ortamı: Otomatik tip üretimi, sıcak yeniden yükleme ve güçlü bir CLI ile hızlı geliştirme.
• Çalışma Zamanı (Runtime): Tip güvenli servislerinizi çalıştıran, doğrulama ve hata yönetimini üstlenen sistem.
• Modül Ekosistemi: Projenizi kolayca genişletmenizi ve özelleştirmenizi sağlayan modüller.

Silgi, varsayılan olarak akıllı ayarlarla gelir ve görüş sahibidir. Özellikler Rehberi bölümünde tüm olanakları keşfedebilirsiniz. Farklı framework veya araçlarla entegrasyon için Modüller bölümüne, projenize özel ayarlar için Konfigürasyon kısmına göz atabilirsiniz.

Ayrıca Eklenti API'si ve Modül API'si ile tamamen tip destekli, genişletilebilir bir altyapı sunar.

Silgi'nin arkasındaki felsefeyi ve nedenlerini Neden Silgi? bölümünde bulabilirsiniz.

TypeScript Desteği

Silgi, TypeScript ile sıfırdan inşa edilmiştir ve kutudan çıktığı gibi uçtan uca tip güvenliği sunar. Servis şemalarınıza göre otomatik olarak TypeScript tipleri üretir ve giriş/çıkış tiplerinin uygulamanız boyunca doğru şekilde yayılmasını garanti eder.

En iyi deneyim için TypeScript 5.8+ önerilir. Silgi, gelişmiş TypeScript özelliklerinden (template literal types, conditional types, module augmentation) tam olarak yararlanır.

Silgi'yi Çevrimiçi Deneyin

Çok yakında!

İlk Silgi Projenizi Oluşturun

Uyumluluk Notu

Silgi, Node.js 22+ gerektirir ve yalnızca ESM modül sistemiyle çalışır. CommonJS desteklenmez.

pnpm

pnpm create silgi

Bun

bun create silgi

npm

npm create silgi@latest

Yarn

yarn create silgi

Komutu çalıştırdıktan sonra ekrandaki yönergeleri takip edin!

Tüm şablonlar ve detaylar için create-silgi sayfasına bakabilirsiniz: nuxt, nitro, h3 ve daha fazlası.

Proje adını . olarak vererek mevcut dizine kurulum yapabilirsiniz.

Topluluk Şablonları

create-silgi, popüler kullanım senaryoları için temel şablonlarla hızlı başlangıç sağlar. Farklı framework ve araçları içeren topluluk şablonlarını da inceleyebilirsiniz.

Bir şablonu https://github.com/user/project adresinde buluyorsanız, https://github.stackblitz.com/user/project adresiyle çevrimiçi olarak deneyebilirsiniz (URL'de github'dan sonra .stackblitz ekleyin).

Alternatif olarak degit ile bir şablonu hızlıca klonlayabilirsiniz:

npx degit user/project#main my-project
cd my-project

npm install
npm run dev

Manuel Kurulum

Mevcut bir projeye Silgi eklemek için:

1. Silgi paketini kurun:

pnpm

pnpm add silgi

Bun

bun add silgi

npm

npm install silgi

Yarn

yarn add silgi

2. Projenizi başlatmak için Silgi init komutunu çalıştırın:

pnpm

pnpm silgi init

Bun

bun silgi init

npm

npm silgi init

Yarn

yarn silgi init

Ardından temel bir proje yapısı oluşturulur ve geliştirmeye başlayabilirsiniz.

---