Creating a new project
======================

A new Fantastico based project can be easily setup by following this how to. In this how to we are going to create
a project named **fantastico_first**.

#. cd ~/
#. mkdir fantastico_first
#. cd fantastico_first
#. virtualenv-3.2 --distribute pip-deps
#. . pip-deps/bin/activate
#. pip install fantastico
#. fantastico_setup_project.sh python3.2 my_project

The last step might take a while because it will also install all fantastico dependencies (e.g sphinx, sqlalchemy, ...).
Please make sure your replace python3.2 with the correct python version.
In order to test the current project do the following:

#. fantastico_run_dev_server
#. Access http://localhost:12000/mvc/hello-world

Your newly project is setup correctly and it runs fantastico default samples project.

Create first component
----------------------

After the new project it's correctly setup we can create our first component.

#. . pip-deps/bin/activate
#. export FANTASTICO_ACTIVE_CONFIG=my_project.settings.BaseProfile
#. cd my_project
#. mkdir component1
#. cd component1
#. mkdir static
#. Paste an image into static folder (e.g first_photo.jpg)
#. touch __init__.py
#. touch hello_world.py
#. Paste the code listed below into hello_world.py

   .. code-block:: python

      from fantastico.mvc.base_controller import BaseController
      from fantastico.mvc.controller_decorators import ControllerProvider, Controller
      from webob.response import Response

      @ControllerProvider()
      class HelloWorldController(BaseController):
          '''This is a very simple controller provider.'''

          @Controller(url="/component1/hello")
          def say_hello(self, request):
              '''This method simply returns an html hello world text.'''

              msg = "Hello world from my project"

              return Response(content_type="text/html", text=msg)

#. fantastico_dev_server
#. Now you can access `Hello route <http://localhost:12000/component1/hello>`_.
#. Now you can access `First photo route <http://localhost:12000/component1/static/first_photo.jpg>`_.

Customize dev server
--------------------

For understanding how to customize dev server please read :doc:`/get_started/dev_mode`

Customize uwsgi prod server
---------------------------

By design, each Fantastico project provides built in support for running it on `uWSGI server <http://uwsgi-docs.readthedocs.org/en/latest/>`_.
If you want to customize uwsgi parameters for your server you can follow these steps:

#. cd $FANTASTICO_PROJECT_FOLDER/deployment/conf/nginx
#. nano fantastico-uwsgi.ini
#. Change the options you want and save the file.
#. fantastico_run_prod_server (for testing the production server).
#. Be aware that first you need an nginx configured and your project config file deployed (Read :doc:`/how_to/deployment_how_to`).