Instalasi dan Pengaturan Vinexel
Prasyarat
Bagian berjudul Prasyarat- Composer –
v18.17.1atauv20.3.0atau yang lebih baru. (v19tidak didukung.) - PHP –
v8.3atau yang lebih baru. (v5tidak didukung.) - Golang (Opsional) –
v18.17.1 - Server Lokal – Direkomendasikan menggunakan Laragon untuk menjalankan server pengembangan, atau XAMPP (opsional) untuk pengelolaan database.
- Editor Teks – Direkomendasikan menggunakan Visual Studio Code.
- Terminal – Vinexel dijalankan melalui antarmuka baris perintah (Command Line Interface / CLI).
Memulai Proyek Baru
Bagian berjudul Memulai Proyek BaruInstalasi Melalui CLI Wizard
Bagian berjudul Instalasi Melalui CLI Wizard-
Jalankan perintah berikut di terminal kamu untuk memulai wizard instalasi Vinexel melalui Composer:
Terminal window composer create-project vinexel/vinexel my-projectKamu dapat menjalankan perintah
create-projectdi mana saja di komputer kamu menggunakan Composer, tetapi disarankan untuk membuat proyek di dalam folderhtdocs(jika menggunakan XAMPP) atauwww(jika menggunakan Laragon). Tidak perlu membuat folder kosong terlebih dahulu—wizard akan otomatis membuatkannya untuk kamu.Jika proses instalasi berhasil, kamu akan melihat pesan sukses diikuti dengan langkah-langkah berikutnya yang direkomendasikan. Setelah proyek kamu berhasil dibuat, jalankan perintah
cduntuk masuk ke direktori proyek baru kamu dan mulai menggunakan Vinexel. -
Setelah itu, kamu dapat menjalankan server pengembangan Vinexel dan melihat pratinjau langsung proyek kamu saat membangun aplikasi!
Edit Proyek Kamu
Bagian: Edit Proyek KamuUntuk melakukan perubahan pada proyek kamu, buka folder proyek di editor kode pilihan kamu. Bekerja dalam mode pengembangan dengan server dev yang sedang berjalan memungkinkan kamu melihat pembaruan pada situs secara langsung saat kamu mengedit kode.
Menjalankan Server Pengembangan Vinexel dengan Vision
Bagian: Menjalankan Server Pengembangan VinexelVinexel dilengkapi dengan server pengembangan bawaan yang menyediakan semua yang kamu butuhkan untuk pengembangan proyek.
Perintah vision pada CLI akan memulai server pengembangan lokal sehingga kamu dapat melihat situs baru kamu berjalan secara langsung.
Setiap template awal sudah menyertakan skrip yang dikonfigurasi untuk menjalankan vision serve.
Setelah kamu masuk ke direktori proyek, gunakan terminal favorit kamu untuk menjalankan perintah ini dan memulai server pengembangan Vinexel.
php vision serve
php vision serve {port}
go run main.go
Jika semuanya berjalan dengan baik, Vinexel kini akan menayangkan proyek kamu di http://localhost:4321/. Kunjungi tautan tersebut di browser kamu untuk melihat situs baru kamu!
Work in development mode
Section titled Work in development modeAstro will listen for live file changes in your src/ directory and update your site preview as you build, so you will not need to restart the server as you make changes during development. You will always be able to see an up-to-date version of your site in your browser when the dev server is running.
When viewing your site in the browser, you’ll have access to the Astro dev toolbar. As you build, it will help you inspect your islands, spot accessibility issues, and more.
If you aren’t able to open your project in the browser after starting the dev server, go back to the terminal where you ran the dev command and check the message displayed. It should tell you if an error occurred, or if your project is being served at a different URL than http://127.0.0.1:8000/ by default if not with specific project port.
Configure your dev environment
Section titled Configure your dev environmentExplore the guides below to customize your development experience.
Next Steps
Section titled Next StepsSuccess! You are now ready to start building awesome project with Vinexel! 🥳
Here are a few things that we recommend exploring next. You can read them in any order. You can even leave our documentation for a bit and go play in your new Astro project codebase, coming back here whenever you run into trouble or have a question.
Explore Vinexel’s Features
Section titled Explore Vinexel’s FeaturesLast Setup
Section titled Manual SetupThis guide will walk you through the steps to manually install and configure a new Astro project.
If you prefer not to use our automatic create astro CLI tool, you can set up your project yourself by following the guide below.
-
Install Vinexel
First, install the Vinexel project dependencies inside your project.
You’ll use these scripts later in the guide to start Astro and run its different commands.
-
Add dependencies support if you want
If you do intend to write TypeScript code, using Astro’s
strictorstrictesttemplate is recommended. You can view and compare the three template configurations at astro/tsconfigs/.Create
tsconfig.jsonat the root of your project, and copy the code below into it. (You can usebase,strict, orstrictestfor your TypeScript template):tsconfig.json {"extends": "astro/tsconfigs/base"}Read Astro’s TypeScript setup guide for more information.
-
Next Steps
If you have followed the steps above, your project directory should now look like this:
-
Directoryapp/
-
Directory{project-1}/
- .env
Directorycontrollers/
Directorymodels/
Directoryviews/
-
Directory{project-2}/
- .env
Directorycontrollers/
Directorymodels/
Directoryviews/
- RegisterProject.php
-
-
-
Directorypublic/
-
Directorystatic/
Directory{project-1}/
Directory{project-2}/
- .htaccess
- robots.txt
- index.php
-
-
Directoryrestapi/
- …
-
Directorysystem/
- …
-
Directoryvendor/
- …
- .gitignore
- go.mod
- go.sum
- composer.json for
package,dependencies, etc. - composer.lock
- vision
-
You can now start the Vinexel development server and see a live preview of your project while you build!