README

A web application skeleton built with Nette Framework, Nettrine (Doctrine ORM for Nette), and Vite, featuring ready-to-use user login/registration, translations via contributte/translation and contributte/datagrid. This project comes pre-configured with Bootstrap 5 and Tabler for a responsive administration UI.

Features

Stack: Nette 3.2, PHP 8.2+, Vite (HMR + auto reload for Latte templates).
ORM: Doctrine 2 via Nettrine.
Auth: Pre-configured user registration, login, and basic management example
Admin UI: Tabler Admin Dashboard (Bootstrap 5) with a responsive layout.
DataGrid: Powerful datagrid via ublaboo/datagrid and @contributte/datagrid.
AJAX: AJAX support via Naja.
Translations: Multi-language support using contributte/translation.
Assets: Nette assets support with Vite.
Tools: PHP-CS-Fixer for code style, PHPStan for static analysis, Nette Tester for testing, and Tracy for debugging.
CLI: Console support via contributte/console.
Icons: Bootstrap Icons (CDN).
Forms: Custom BootstrapRenderer and BootstrapHorizontalRenderer for easy Bootstrap 5 form rendering in administration.

private/app: PHP application logic (Presenters, Models, Services).
- Model: Doctrine entities, repositories, and facades.
- Presentation: Latte templates and Nette presenters.
private/config: Configuration files (NEON).
private/lang: Translation files.
private/assets: Frontend source files (JS, CSS).
web: Public directory (entry point, compiled assets).
tests: Unit and integration tests.

Install via Composer

composer create-project martyd420/nette-starter my-project
cd my-project

Install Frontend dependencies
```
nvm use 22
npm install
```
Database Configuration

Default configuration requires a local mysql/mariadb database nsdb (user: nettestarter, pass: nettestarter123). Use these credentials or override them in private/config/local.neon. Default database credentials are intended for local development only. See private/config/local.neon.example for reference.
Initialize Database

Run the following command to create the schema and load default fixtures (admin user):
```
composer db:reset
```
Build Assets For production build:
```
npm run build
```

This will start the Vite development server (usually on port 5173) with Hot Module Replacement (HMR).

npm run dev

You can use the built-in PHP server or your preferred web server (Apache/Nginx/Docker). To use the built-in PHP server:

php -S localhost:8000 -t web

Access the application at: http://localhost:8000

For further database changes during development, you can use Doctrine migrations or schema-tool via console:

# Generate migration
php private/cli/console.php migrations:diff

# Apply migrations
php private/cli/console.php migrations:migrate

The composer db:reset command creates a default administrator account - development only credentials:

Defined in composer.json:

composer db:reset: Destructive! Drops the database schema, clears cache, creates new schema, and loads fixtures.
composer cs:check: Checks code style with PHP-CS-Fixer (dry-run).
composer cs:fix: Automatically fixes code style with PHP-CS-Fixer.
composer phpstan: Runs static analysis on private/app.
composer tester: Runs unit/integration tests.
php private/cli/console.php: Access to various Doctrine and system commands.

Defined in package.json: