planette/nutella-project

Nutella project is full featured web app kit based on Nette Framework + Contributte and many useful packages by @f3l1x.

Installs: 10 619

Dependents: 0

Suggesters: 0

Security: 0

Stars: 33

Watchers: 4

Forks: 7

Open Issues: 0

Type:project


README

Nutella project is full featured web app kit based on Nette Framework + Contributte and many useful packages by @f3l1x.

Why nutella? Because it's all mixed into 1 awesome piece.

🕹 f3l1x.io | 💻 f3l1x | 🐦 @xf3l1x

composer create-project -s dev planette/nutella-project acme

Take a look at demo examples.contributte.org/planette/nutella-project/

screenshot1.png

Build Status Join the chat

Goal

Main goal is to provide best prepared starter-kit project for Nette developers.

Focused on:

  • nette/* packages
  • Doctrine ORM via nettrine/*
  • Symfony components via contributte/*
  • codestyle checking via CodeSniffer and ninjify/*
  • static analysing via phpstan
  • unit / integration tests via Nette Tester and ninjify/*

Demo

https://examples.contributte.org/planette/nutella-project/

Install with docker

  1. At first, use composer to install this project.

    composer create-project planette/nutella-project
    
  2. After that, you have to setup Postgres >= 10 database. You can start it manually or use docker image postgres:10.

    docker run -it -p 5432:5432 -e POSTGRES_PASSWORD=nutella -e POSTGRES_USER=nutella postgres:10
    

    Or use make task, make loc-postgres.

  3. Custom configuration file is located at app/config/config.local.neon. Edit it if you want.

    Default configuration should look like:

    # Host Config
    parameters:
    
        # Database
        database:
            host: localhost
            dbname: nutella
            user: nutella
            password: nutella
  4. Ok database is now running and application is configured to connect to it. Let's create initial data.

    Run NETTE_DEBUG=1 bin/console migrations:migrate to create tables. Run NETTE_DEBUG=1 bin/console doctrine:fixtures:load --append to create first user(s).

    Or via task make build.

  5. Start your devstack or use PHP local development server.

    You can start PHP server by running php -S localhost:8000 -t www or use prepared make task make loc-web.

  6. Open http://localhost and enjoy!

    Take a look at:

Install with docker-compose

  1. At first, use composer to install this project.

    composer create-project planette/forest-project
    
  2. Modify app/config/config.local.neon and set host to database

    Default configuration should look like this:

    # Host Config
    parameters:
    
        # Database
        database:
            host: database
            dbname: nutella
            user: nutella
            password: nutella
  3. Run docker-compose up

  4. Open http://localhost and enjoy!

    Take a look at:

Features

Here is a list of all features you can find in this project.

  • 📦 Packages
    • Nette 3.0
    • Contributte
    • Nettrine
  • 🌳 Structure
    • app
      • config - configuration files
        • env - prod/dev/test environments
        • app - application configs
        • ext - extensions configs
        • config.local.neon - local runtime config
        • config.local.neon.dist - template for local config
      • domain - business logic and domain specific classes
      • model - application backbone
      • modules - Front/Admin module, presenters and components
      • resources - static content for mails and others
      • ui - UI components and base classes
      • bootstrap.php - Nette entrypoint
    • bin - console entrypoint (bin/console)
    • db - database files
      • fixtures - PHP fixtures
      • migrations - migrations files
    • docs - documentation
    • log - runtime and error logs
    • temp - temp files and cache
    • tests - test engine and unit/integration tests
    • vendor - composer's folder
    • www - public content
  • ❗ Tracy
    • Cool error 500 page

Composer packages

Take a detailed look 👀 at each single package.

Nettrine

Nette

Demo

admin@admin.cz / admin

Development

See how to contribute to this package.

This package is currently maintaining by these authors.

538058?v=3&s=80

Consider to support planette development team. Also thank you for using this project.