推奨: degit
degitはGit履歴を含まない最新のテンプレートをダウンロードし、クリーンな状態で始められます。
varshaはAstro上に構築されたプレミアムWebサイトスターターテンプレートです。このガイドでは、前提条件、インストール方法、ローカル開発サーバーの初回起動について説明します。
varshaをインストールする前に、以下のツールが必要です:
| ツール | 最小バージョン | 備考 |
|---|---|---|
| Node.js | 18.17.0 または 20.3.0+ | LTS推奨 |
| npm | 9.0+ | Node.jsに付属 |
| コードエディター | — | VS CodeとAstro拡張機能推奨 |
| Git | 2.0+ | クローンとデプロイに必要 |
Node.jsのバージョンを確認するには:
node --version以下の方法から1つ選んで新しいvarshaプロジェクトを作成してください。
推奨: degit
degitはGit履歴を含まない最新のテンプレートをダウンロードし、クリーンな状態で始められます。
Git clone
コントリビュートする場合やGit履歴を保持したい場合はフルリポジトリをクローンします。
npm create
Astro CLIでvarshaテンプレートフラグを使用します。
npx degit yethikrishna/web-ui-template my-varsha-sitecd my-varsha-sitenpm installこれにより、元のGit履歴を除いたvarshaスターターの新しいコピーを含むmy-varsha-siteディレクトリが作成されます。
git clone https://github.com/yethikrishna/web-ui-template.git my-varsha-sitecd my-varsha-sitenpm installGitでクローンした場合は、コミットする前に既存のリモートを削除して自分のリモートを追加することを検討してください:
git remote remove origingit remote add origin https://github.com/your-username/your-repo.gitnpm create astro@latest -- --template yethikrishna/web-ui-template my-varsha-sitecd my-varsha-sitenpm installローカル開発サーバーを起動します:
npm run devデフォルトでは、varshaはhttp://localhost:4321で実行されます。ブラウザでこのURLを開くとサイトが表示されます。
開発サーバーは以下をサポートしています:
.astro、.mdx、.css、.tsファイルの変更はフルページリロードなしで即座に反映されます。--hostを追加するとローカルネットワーク上で公開されます:npm run dev -- --host。varshaには以下のnpmスクリプトが標準で用意されています:
| スクリプト | コマンド | 目的 |
|---|---|---|
dev | npm run dev | ローカル開発サーバーを起動 |
build | npm run build | プロダクションビルドを./dist/に生成 |
preview | npm run preview | デプロイ前にプロダクションビルドをローカルでプレビュー |
astro | npx astro | Astro CLIコマンドを直接実行 |
npm run devを実行した後、以下が表示されることを確認してください:
http://localhost:4321/)http://localhost:4321/docs/)http://localhost:4321/blog/)3つのページすべてが読み込まれれば、インストールは正常に完了しています。
クイックスタート
5分で最初のカスタムページを作成してデプロイします。
プロジェクト構造
varshaプロジェクトの構成方法を理解します。