راهنمای شروع سریع

برای راه‌اندازی سریع یک پروژه جدید Next.js با نام my-app و اجرای سرور توسعه (Development Server)، دستورالعمل‌های زیر را دنبال کنید.

اجرای دستورات در ترمینال

ابتدا با استفاده از یکی از ابزارهای مدیریت بسته (Package Manager)، پروژه خود را ایجاد کرده و سپس سرور را بنویسید:

# ایجاد پروژه جدید Next.js
pnpm create next-app@latest my-app --yes

# ورود به پوشه پروژه
cd my-app

# اجرای سرور توسعه
pnpm dev

نکته مهم: استفاده از فلگ --yes باعث می‌شود که تمام پرسش‌های اولیه حین نصب نادیده گرفته شوند و پروژه بر اساس تنظیمات پیش‌فرض یا ذخیره‌شده قبلی ساخته شود.

در حالت پیش‌فرض، امکانات زیر به صورت خودکار فعال و پیکربندی می‌شوند:

• زبان TypeScript و استایل‌دهی با Tailwind CSS

• ابزار بررسی خطاهای کد پیش از اجرا (ESLint)

• معماری مسیردهی جدید (App Router) و موتور ساخت سریع (Turbopack)

• پیکربندی مستعار برای آدرس‌دهی مسیرها (@/* Import Alias)

• فایل‌های راهنمای هوش مصنوعی شامل AGENTS.md و CLAUDE.md جهت هدایت ابزارهای کدنویسی هوشمند برای نگارش کدهای به‌روز در Next.js

پس از اجرای سرور، پروژه شما در آدرس زیر در دسترس خواهد بود:

آدرس محلی: http://localhost:3000

نیازمندی‌های سیستمی (System Requirements)

پیش از شروع کار، مطمئن شوید که محیط توسعه شما شرایط و پیش‌نیازهای زیر را دارا است:

• حداقل نسخه Node.js: نسخه 20.9 یا بالاتر

• سیستم‌عامل‌های پشتیبانی‌شده: macOS، Windows (شامل توزیع‌های WSL) و Linux

مرورگرهای مورد پشتیبانی (Supported Browsers)

فریم‌ورک Next.js بدون نیاز به هیچ‌گونه تنظیمات اضافی (Zero Configuration)، از مرورگرهای مدرن زیر پشتیبانی می‌کند:

ساخت پروژه با ابزار خط فرمان (Create with the CLI)

سریع‌ترین راه برای راه‌اندازی یک برنامه جدید، استفاده از ابزار رسمی create-next-app است که تمام بخش‌های ساختاری را به صورت خودکار پیکربندی می‌کند. برای شروع، دستور زیر را اجرا کنید:

pnpm create next-app

مراحل پله‌پله فرآیند نصب (Installation Prompts)

هنگام نصب، اعلان‌ها و پرسش‌های زیر در ترمینال ظاهر می‌شوند تا ویژگی‌های پروژه را تعیین کنید:

What is your project named? my-app
Would you like to use the recommended Next.js defaults?
    Yes, use recommended defaults - TypeScript, ESLint, Tailwind CSS, App Router, AGENTS.md
    No, reuse previous settings
    No, customize settings - Choose your own preferences

در صورتی که گزینه شخصی‌سازی تنظیمات (Customize settings) را انتخاب کنید، گزینه‌های زیر جهت پیکربندی دقیق‌تر در اختیار شما قرار می‌گیرند:

Would you like to use TypeScript? No / Yes
Which linter would you like to use? ESLint / Biome / None
Would you like to use React Compiler? No / Yes
Would you like to use Tailwind CSS? No / Yes
Would you like your code inside a `src/` directory? No / Yes
Would you like to use App Router? (recommended) No / Yes
Would you like to customize the import alias (`@/*` by default)? No / Yes
What import alias would you like configured? @/*
Would you like to include AGENTS.md to guide coding agents to write up-to-date Next.js code? No / Yes

پس از پاسخ به این پرسش‌ها، ابزار create-next-app پوشه‌ای هم‌نام با پروژه شما ایجاد کرده و تمامی وابستگی‌های (Dependencies) مورد نیاز را به صورت خودکار نصب خواهد کرد.