Modern ve şık kullanıcı arayüzleri oluşturmak, ön yüz geliştiricileri için temel hedeflerden biridir ve bileşen kütüphanelerinin yükselişiyle bu görev daha da kolay hale gelmiştir. Bugün, size React.js için güçlü ve özelleştirilebilir bir bileşen kütüphanesi olan Shadcn/UI'yi tanıtacağım. İster React.js'ye yeni başlayın, ister deneyimli bir geliştirici olun, Shadcn/UI, uygulamanızın tasarımını daha büyük çerçevelerin alışılagelmiş şişkinliği olmadan geliştirebilir. Ayrıca, API'ler ve Apidog gibi araçlardan nasıl yararlanacağınız da dahil olmak üzere, kurulumu adım adım anlatacağım ve geliştirme sürecini daha sorunsuz hale getireceğim.
Bu yazının sonunda, Shadcn/UI'yi React.js projenizde nasıl kullanacağınız konusunda net bir anlayışa sahip olacaksınız. Ve, kendi API'nizi oluşturuyorsanız veya bir API ile çalışıyorsanız, API'leri test ederken ve geliştirirken hayat kurtarıcı olan Apidog'u ücretsiz indirmeyi unutmayın.
Hadi başlayalım!
Shadcn/UI Nedir?
Kuruluma dalmadan önce, önce Shadcn/UI'nin ne olduğunu ve neden React.js projeniz için sağlam bir seçim olduğunu tanımlayalım.
Shadcn/UI, özellikle React.js için oluşturulmuş, özelleştirilebilir bir bileşen kütüphanesidir. Material UI veya Bootstrap gibi daha büyük çerçevelerden farklı olarak, Shadcn/UI size bileşenlerinizin görünümü ve hissi üzerinde daha fazla kontrol sağlamaya odaklanır. Önceden tanımlanmış temalara bağlı kalmadan benzersiz bir arayüz oluşturmanıza olanak tanıyan temel yapı taşları sağlar.
Neden Shadcn/UI?
- Hafif: Kullanmayacağınız tonlarca bileşeni bir araya getiren ağır kütüphanelerin aksine, Shadcn/UI yalnızca ihtiyacınız olanı sağlar.
- Özelleştirilebilir: Bileşenleri projenizin benzersiz gereksinimlerine göre stilize edebilir ve yapılandırabilirsiniz.
- React.js için Optimize Edilmiş: React.js ile sorunsuz entegrasyon, yapılandırmaları ayarlamak yerine kod yazmaya odaklanabileceğiniz anlamına gelir.
- API'lere Hazır: Kütüphane, Apidog gibi API araçlarıyla uyumludur ve React uygulamanız içinde API uç noktalarını yönetmeyi ve test etmeyi kolaylaştırır.
Adım Adım Kılavuz: React.js Projenizde Shadcn/UI Nasıl Kullanılır
Shadcn/UI'nin ne olduğunu bildiğinize göre, onu bir React.js projesine entegre etme sürecini adım adım inceleyelim. Bu kılavuz, zaten React hakkında temel bir anlayışa sahip olduğunuzu ve makinenizde Node.js'nin yüklü olduğunu varsaymaktadır.
1. Yeni Bir React.js Projesi Oluşturun
Zaten kurulmuş bir React.js projeniz varsa, bu adımı atlayabilirsiniz. Aksi takdirde, aşağıdaki komutları kullanarak yeni bir proje oluşturabilirsiniz:
npx create-react-app my-shadcn-ui-app
cd my-shadcn-ui-app
npm start
Bu, my-shadcn-ui-app
adlı yeni bir React.js projesi oluşturacak ve geliştirme sunucusunu başlatacaktır. Şimdi, varsayılan React uygulamasının çalışır durumda olduğunu görmelisiniz.
2. Shadcn/UI'yi Yükleyin
Projenize bağımlılıkları manuel olarak ekleyin.
Tailwind CSS Ekleme
Bileşenler, Tailwind CSS kullanılarak stilize edilir. Projenize Tailwind CSS yüklemeniz gerekir.
Başlamak için Tailwind CSS kurulum talimatlarını izleyin.
Bağımlılıkları Ekleme
Projenize aşağıdaki bağımlılıkları ekleyin:
npm install tailwindcss-animate class-variance-authority clsx tailwind-merge
Simge kütüphanesi ekleyin
default
stilini kullanıyorsanız, lucide-react
'i yükleyin:
npm install lucide-react
new-york
stilini kullanıyorsanız, @radix-ui/react-icons
'i yükleyin:
npm install @radix-ui/react-icons
Yol takma adlarını yapılandırın
@
takma adını kullanıyorum. Bunu tsconfig.json'da şu şekilde yapılandırıyorum:tsconfig.json
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["./*"]
}
}
}
@
takma adı bir tercihtir. İsterseniz başka takma adlar da kullanabilirsiniz.
~ gibi farklı bir takma ad kullanıyorsanız, bileşen eklerken import ifadelerini güncellemeniz gerekir.
Artık projenize bileşen eklemeye başlayabilirsiniz.
3. Shadcn/UI Bileşenlerini İçe Aktarın ve Kullanın
Eğlenceli kısma geçelim; React.js uygulamanıza bazı Shadcn/UI bileşenleri ekleyelim. src/App.js
dosyanızda, Shadcn/UI'nin bileşenlerinden biri olan düğme bileşenini içe aktararak ve kullanarak başlayabilirsiniz.
İşte bir örnek:
import React from 'react';
import { Button } from 'shadcn-ui';
function App() {
return (
<div className="App">
<header className="App-header">
<h1>My Shadcn/UI Uygulamasına Hoş Geldiniz</h1>
<Button variant="primary">Tıkla!</Button>
</header>
</div>
);
}
export default App;
Shadcn/UI'den gelen Button
bileşeni, App
bileşenine içe aktarılır ve kullanılır. Özelleştirmek için çeşitli props kullanabilirsiniz. Bu durumda, düğmeye birincil stil vermek için variant="primary"
prop'unu kullanıyoruz.
4. Shadcn/UI Temasını Özelleştirin
Shadcn/UI'nin en iyi kısımlarından biri, özelleştirilebilir olmasıdır. Uygulamanızın benzersiz tasarım diline uyacak şekilde bileşenleri ayarlayabilirsiniz.
Shadcn/UI, genel olarak uygulanabilen özel bir tema tanımlamanıza olanak tanır. Bunu nasıl yapacağınız aşağıda açıklanmıştır:
a) Özel Bir Tema Dosyası Oluşturun
İlk olarak, src
dizininizde theme.js
adlı yeni bir dosya oluşturun. Bu dosyada, özel temanızı aşağıdaki gibi tanımlayacaksınız:
const theme = {
colors: {
primary: '#ff6347', // Domates rengi
secondary: '#4caf50', // Yeşil renk
},
fonts: {
body: 'Arial, sans-serif',
heading: 'Georgia, serif',
},
};
export default theme;
b) Temayı Bileşenlerinize Uygulayın
Özel temanızı tanımladığınıza göre, ThemeProvider bileşenini kullanarak bileşenlerinize uygulayabilirsiniz. src/App.js
dosyanızı aşağıdaki gibi güncelleyin:
import React from 'react';
import { Button, ThemeProvider } from 'shadcn-ui';
import theme from './theme';
function App() {
return (
<ThemeProvider theme={theme}>
<div className="App">
<header className="App-header">
<h1>My Shadcn/UI Uygulamasına Hoş Geldiniz</h1>
<Button variant="primary">Tıkla!</Button>
</header>
</div>
</ThemeProvider>
);
}
export default App;
Bu güncellenmiş kodda, Shadcn/UI'den ThemeProvider
'ı içe aktardık ve uygulamamızı içine sardık, özel theme
'i bir prop olarak geçirdik.
5. Shadcn/UI + React Projenizde Apidog ile API'leri Yönetme
Ön yüzünüz Shadcn/UI ile harika göründüğüne göre, onu bir API'ye bağlayarak işlevsel hale getirmenin zamanı geldi. İşte bu noktada Apidog devreye giriyor. Apidog'u daha önce duymadıysanız, API testini, dokümantasyonunu ve geliştiriciler arasındaki işbirliğini basitleştiren sağlam bir API yönetim aracıdır.
React.js Uygulamanızla Neden Apidog Kullanmalısınız?
- API testi kolaylaştı: API uç noktalarınızı doğrudan React projenizde test edebilirsiniz.
- Kesintisiz işbirliği: Apidog, ekibinizle API dokümantasyonu oluşturmanıza ve paylaşmanıza olanak tanır.
- Geliştirmeyi hızlandırın: Geliştirme sürecini hızlandırmak için API yanıtlarını kolayca taklit edin.
API Çağrıları için Apidog Kullanma
Bir hava durumu API'sinden veri getiren bir React.js uygulaması oluşturduğunuzu varsayalım. API çağrılarını yönetmek için Apidog'u şu şekilde kullanabilirsiniz:
Adım 1: Apidog'u açın ve yeni bir istek oluşturun.

Adım 2: Test düzenleyicisinde, API uç noktanızın URL'sini girin, HTTP yöntemini seçin ve ihtiyacınız olan tüm başlıkları, parametreleri veya gövde verilerini ekleyin. Örneğin, daha önce oluşturduğumuz basit bir mesaj döndüren rotayı test edebilirsiniz:

Adım 3: Gönder düğmesine tıklayın ve testinizin sonucunu görün. Durum kodunu, yanıt süresini ve API'nizin yanıt gövdesini görmelisiniz. Örneğin, şuna benzer bir şey görmelisiniz:

Apidog, web hizmetlerinizin kalitesini, güvenilirliğini ve performansını sağlamanıza yardımcı olduğundan, API'lerinizi test etmek için harika bir araçtır. Ayrıca, API'lerinizi test etmek için herhangi bir kod yazmanıza veya herhangi bir yazılım yüklemenize gerek olmadığından, size zaman ve çaba tasarrufu sağlar. Sadece tarayıcınızı kullanabilir ve Apidog'un kullanıcı dostu arayüzünün ve özelliklerinin keyfini çıkarabilirsiniz.
6. React.js'de Shadcn/UI ve Apidog Kullanımı İçin En İyi Uygulamalar
Shadcn/UI ve Apidog'dan en iyi şekilde yararlanmak için izlemeniz gereken bazı en iyi uygulamalar şunlardır:
- Performansı optimize edin: Paket boyutunuzu küçük tutmak için yalnızca ihtiyacınız olan Shadcn/UI bileşenlerini kullanın.
- Bileşenlerinizi modülerleştirin: UI'nizi küçük, yeniden kullanılabilir bileşenlere ayırın.
- API'lerinizi test edin: API uç noktalarınızın beklendiği gibi çalıştığından emin olmak için Apidog'u kullanarak kapsamlı bir şekilde test edin.
- Sürüm kontrolü kullanın: İlerlemeyi kaybetmemek ve ekibinizle etkili bir şekilde işbirliği yapmak için değişikliklerinizi düzenli olarak kaydedin.
Sonuç: Shadcn/UI ve Apidog ile React.js Uygulamaları Oluşturma
Tebrikler! Artık React.js projelerinizde Shadcn/UI'yi kullanmak için ihtiyacınız olan tüm bilgilere sahipsiniz. Kütüphaneyi kurmaktan bileşenleri özelleştirmeye kadar, güzel UI'ler oluşturmanın ne kadar kolay olduğunu gördünüz. Ve Apidog ile API çağrılarınızı yönetmek çocuk oyuncağı haline geliyor.
Unutmayın, ister dahili bir araç isterse müşteri odaklı bir uygulama oluşturuyor olun, Shadcn/UI size benzersiz bir şey yaratma esnekliği sağlarken, Apidog API iş akışınızı kolaylaştırmaya yardımcı olur.
Not: API'ler üzerinde çalışıyorsanız, Apidog'u ücretsiz indirmeyi unutmayın; size saatlerce geliştirme ve test süresi kazandıracaktır!