Getting Started

Once you've completed everything in the Pre-requisites section, you're fully equipped to start using VeltoPHP in your next web project.

VeltoPHP is a lightweight and developer-friendly framework built specifically for those who want to create clean, structured, and fast web applications without the overhead of large, complex frameworks. Whether you're working on a small prototype, a community project, or a custom backend system — VeltoPHP is designed to get out of your way and let you build.

The framework is based on the HMVC (Hierarchical Model-View-Controller) architecture, which promotes modular development. This structure makes your codebase more organized, easier to scale, and more maintainable over time.

Let's Begin the Installation

To get started, the first step is to open your terminal or command prompt.

Then, type the following command to begin installing VeltoPHP:

composer create-project veltophp/velto new-velto

Make sure you're in the directory where you want your new project to be created.

=============================================
VeltoPHP V.2 has been installed successfully!
=============================================

Welcome to VeltoPHP 2.0 
Let's get you started...

✅ .env file created from .env.example
Do you want to run database migrations now? (yes/no) [yes]: yes

 Running migrations...

✅ Migrated: 2025_06_26_100533_create_homes_table
✅ Migrated: 2025_06_26_100709_create_users_table
✅ Migrated: 2025_06_28_054649_create_axions_table

✅ Migrations completed successfully.

 Go to your project directory and run `php velto start`. 


 You're all set. Happy coding with VeltoPHP 2.0!

Once you run the command, VeltoPHP will take care of the rest — setting up the folder structure, downloading necessary dependencies, and getting your application ready to build.

Open your project directory

cd new-velto

The result

new-velto % ls -a
.		.env.example	LICENSE		composer.lock	readme.md	velto
..		.gitattributes	app		modules		resources	vendor
.env		.gitignore	composer.json	public		storage

To start your project

php velto start

Starting Velto development server...

🌐 Access URLs:
┌───────────────┬──────────────────────────────┐
│   Interface   │           Address            │
├───────────────┼──────────────────────────────┤
│ Localhost     │ http://localhost:8000        │
│ Loopback      │ http://127.0.0.1:8000        │
│ Local Network │ http://192.168.101.6:8000    │
└───────────────┴──────────────────────────────┘

Press Ctrl+C to stop the server

[Sun Aug  3 13:16:34 2025] PHP 8.4.10 Development Server (http://0.0.0.0:8000) started

Open your browser and type the local ip , http://localhost:8000

Default homepage VeltoPHP V2

💡 Note: Internet Connection Required for Tailwind CSS

VeltoPHP by default uses the Tailwind CSS CDN to style its default views. This means the styles are loaded directly from the internet using a Content Delivery Network (CDN).

To ensure that your VeltoPHP project looks and works as expected, please make sure your computer is connected to the internet while developing or viewing the application in the browser.

If you prefer to work offline or want more control, you can always replace the CDN with a local build of Tailwind CSS.