Temel site
Bu sayfada
İşe yarar en küçük sitelo sitesi: bir sayfa, bir stil sayfası ve dist/ dizinini yayımlayan sunucu yapılandırmaları. Yapılandırmaları herhangi bir sitelo projesine kopyalayın — yalnızca npm run build → dist/ varsayarlar.
Çalıştırılabilir bir kopyası sitelo deposunda examples/basic/ altında bulunur.
Elinize geçenler
- sitelo ile kurulmuş tek sayfalık bir statik site
netlify.toml,vercel.json,wrangler.jsonc,amplify.yml,cloudfront-function.js,staticwebapp.config.json,firebase.json,.gitlab-ci.yml,render.yaml,.do/app.yaml,Caddyfile,Dockerfile,fly.toml,heroku.ymlvenginx.conf- Örnek klasöründen tek tıkla / depo bağlayarak dağıtım
Proje düzeni
my-site/
sitelo.config.js
netlify.toml # Netlify
vercel.json # Vercel
wrangler.jsonc # Cloudflare Workers
amplify.yml # AWS Amplify
cloudfront-function.js # AWS S3 + CloudFront
firebase.json # Firebase Hosting
.gitlab-ci.yml # GitLab Pages
render.yaml # Render
.do/app.yaml # DigitalOcean App Platform
Caddyfile # Railway, Fly.io, Heroku, Cloud Run
Dockerfile # Railway, Fly.io, Heroku, Cloud Run
.dockerignore # Railway, Fly.io, Heroku, Cloud Run
fly.toml # Fly.io
heroku.yml # Heroku
nginx.conf # Your own server
package.json
public/
staticwebapp.config.json # Azure Static Web Apps
src/
index.ht.js
css/
styles.cssexport default () => `
<html lang="tr">
<head>
<title>sitelo — temel örnek</title>
<link rel="stylesheet" href="/css/styles.css">
</head>
<body>
<h1>sitelo’dan merhaba</h1>
</body>
</html>
`import { html, head, title, link, body, h1 } from 'javascript-to-html'
export default () =>
html({ lang: 'tr' },
head(
title('sitelo — temel örnek'),
link({ rel: 'stylesheet', href: '/styles.css' }),
),
body(h1('sitelo’dan merhaba')),
)export default function Home() {
return (
<html lang="tr">
<head>
<title>sitelo — temel örnek</title>
<link rel="stylesheet" href="/css/styles.css" />
</head>
<body>
<h1>sitelo’dan merhaba</h1>
</body>
</html>
)
}Derleme
npm install
npm run buildDağıtım
sitelo tek depodan çalışıyorsanız platformun kök/temel dizinini examples/basic olarak ayarlayın.
Netlify
[build]
command = "npm run build"
publish = "dist"Vercel
{
"$schema": "https://openapi.vercel.sh/vercel.json",
"framework": null,
"buildCommand": "npm run build",
"outputDirectory": "dist",
"installCommand": "npm install"
}Vercel’e dağıt · Netlify’a dağıt (sorulduğunda temel dizini examples/basic yapın).
Cloudflare
Cloudflare artık yeni projeler için Workers’ı öneriyor. npx wrangler deploy derleyip dist/ dizinini yükler; ya da depoyu Cloudflare panelinde bağlayın. Pages kullanıyorsanız derleme komutu npm run build, çıktı dizini dist olsun.
{
"name": "sitelo-basic",
"compatibility_date": "2026-10-01",
"build": {
"command": "npm run build"
},
"assets": {
"directory": "./dist",
"not_found_handling": "404-page",
"html_handling": "drop-trailing-slash"
}
}AWS Amplify
Depoyu Amplify Hosting’e bağlayın.
version: 1
frontend:
phases:
preBuild:
commands:
- npm install
build:
commands:
- npm run build
artifacts:
baseDirectory: dist
files:
- '**/*'
cache:
paths:
- node_modules/**/*AWS S3 + CloudFront
cloudfront-function.js dosyasını dağıtımın viewer isteklerine bağlayın ve 403 ile 404 için /404.html dosyasını 404 durum koduyla döndüren özel hata yanıtları ekleyin. Ardından her derlemeyi yükleyin:
function handler(event) {
var request = event.request
var uri = request.uri
if (uri.endsWith('/')) {
request.uri += 'index.html'
} else if (uri.slice(uri.lastIndexOf('/') + 1).indexOf('.') === -1) {
request.uri += '/index.html'
}
return request
}npm run build
aws s3 sync dist/ s3://my-bucket --delete
aws cloudfront create-invalidation --distribution-id MY_DISTRIBUTION_ID --paths "/*"Azure Static Web Apps
Static Web App’i uygulama konumu / ve çıktı konumu dist olacak şekilde oluşturun. sitelo public/staticwebapp.config.json dosyasını dist/ içine kopyalar; Azure onu orada okur ve bilinmeyen URL’ler için 404.html sunar.
{
"responseOverrides": {
"404": {
"rewrite": "/404.html"
}
}
}Google Cloud
Firebase Hosting: firebase use --add ile bir proje seçin, ardından firebase deploy siteyi derleyip yükler. Cloud Run için gcloud run deploy --source . aşağıdaki Dockerfile dosyasını derler.
{
"hosting": {
"public": "dist",
"predeploy": "npm run build",
"trailingSlash": false
}
}GitLab Pages
.gitlab-ci.yml dosyasını bir GitLab deposunun köküne kopyalayın; iş derler ve dist/ dizinini yayımlar.
deploy-pages:
image: node:24
script:
- npm ci
- npm run build
pages:
publish: dist
rules:
- if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCHRender
render.yaml dosyasından bir Blueprint oluşturun ya da yeni bir statik sitede aynı derleme komutunu ve yayın dizinini ayarlayın. Temiz URL’ler ve 404.html kural gerektirmeden çalışır.
services:
- type: web
name: sitelo-basic
runtime: static
buildCommand: npm install && npm run build
staticPublishPath: ./distDigitalOcean App Platform
github.repo alanına kendi deponuzu yazın, ardından doctl apps create --spec .do/app.yaml çalıştırın.
name: sitelo-basic
static_sites:
- name: site
github:
repo: your-name/your-site
branch: main
deploy_on_push: true
build_command: npm run build
output_dir: distRailway
Railway Dockerfile dosyasını derler (aşağıdaki Fly.io bölümüne bakın), yani ayarlanacak bir şey yok. Dockerfile olmayan bir projede bunun yerine RAILPACK_SPA_OUTPUT_DIR=dist servis değişkenini ekleyin: Railpack bu durumda dist/ dizinini, bilinmeyen URL’lere 404.html ile yanıt veren Caddyfile üzerinden sunar.
:{$PORT:80} {
root * /app/dist
encode zstd gzip
try_files {path} {path}/index.html
file_server
handle_errors {
rewrite * /{err.status_code}.html
file_server
}
}Fly.io
Dockerfile Node ile derler ve dist/ dizinini Caddy ile sunar. Uygulamayı fly launch ile oluşturun, sonra fly deploy çalıştırın.
FROM node:24-slim AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
FROM caddy:2-alpine
COPY Caddyfile /etc/caddy/Caddyfile
COPY --from=build /app/dist /app/distnode_modules
dist
.gitapp = "sitelo-basic"
[http_service]
internal_port = 80
force_https = true
auto_stop_machines = "stop"
auto_start_machines = true
min_machines_running = 0Heroku
Bir kez heroku stack:set container çalıştırın, sonra git push heroku main: Heroku Dockerfile dosyasını derler ve Caddy için PORT değişkenini ayarlar.
build:
docker:
web: DockerfileKendi sunucunuz
Derlemeyi rsync -a --delete dist/ you@server:/var/www/my-site/ ile sunucuya kopyalayın ve nginx.conf ile sunun — ya da :{$PORT:80} yerine alan adınızı, /app/dist yerine dizini yazarak yukarıdaki Caddyfile ile.
server {
listen 80;
server_name example.com;
root /var/www/my-site;
location / {
try_files $uri $uri/index.html =404;
}
error_page 404 /404.html;
}Render, Railway, Fly.io, Heroku ve Cloud Run yalnızca dağıttıkları klasörü görür; bu yüzden örnekteki sitelo’ya giden file:../.. bağlantısı orada çözülmez — sitelo paketini npm’den kuran bir kopya dağıtın.
Cursor, Copilot ya da başka bir ajanla mı çalışıyorsunuz? Araçlar React/Next kalıpları uydurmasın diye bu örnekten AGENTS.md dosyasını kopyalayın (ya da Yapay zekâ ile geliştirme sayfasına bakın).
Başlarken · Yapay zekâ ile geliştirme · Yapılacaklar uygulaması · Sunucu adaları örneği