Installation

Basic Installation

  1. Run pip install coderedcms

  2. Run coderedcms start mysite --sitename "My Company Inc." --domain www.example.com

    Note

    --sitename and --domain are optional to pre-populate settings of your website.

  3. Enter the mysite project with cd mysite/.

  4. Run python manage.py migrate to create the core models.

  5. Run python manage.py createsuperuser to create the initial admin user.

  6. Run python manage.py runserver to launch the development server, and go to http://localhost:8000 in your browser, or http://localhost:8000/admin/ to log in with your admin account.

✨🎉 You now have CodeRed CMS up and running! 🎉✨

Follow the tutorial to build Your First CodeRed Website: Part 1

Installing with Sass Support

To create a project that is pre-configured to use Sass for CSS compilation:

  1. Run pip install coderedcms

  2. Run

    $ coderedcms start mysite --template sass --sitename "My Company Inc." --domain www.example.com
    

    Note

    --sitename and --domain are optional to pre-populate settings of your website.

  3. Enter the mysite project with cd mysite/.

  4. Install the development tooling with:

    $ pip install -r requirements.txt -r requirements-dev.txt
    
  5. Run python manage.py migrate to create the core models.

  6. Run python manage.py createsuperuser to create the initial admin user.

  7. Compile the scss code into CSS:

    $ python manage.py sass website/static/website/src/custom.scss website/static/website/css/
    

    Note

    To build the Sass automatically whenever you change a file, add the --watch option and run it in a separate terminal. For more options, see django-sass.

  8. Run python manage.py runserver to launch the development server, and go to http://localhost:8000 in your browser, or http://localhost:8000/admin/ to log in with your admin account.

When working with Sass, you will want to look at the base.html file provided at: mysite/website/templates/coderedcms/pages/base.html to load in any custom CSS or JavaScript as needed.

Starter Templates

You can start a new CodeRed CMS project with a custom template directory available on or at a URL using the --template option. Additionally, we provide some built-in templates:

Template

Description

basic

The default CodeRed CMS starter project. The simplest option, good for most sites.

sass

Similar to basic, but with extra tooling to support SCSS to CSS compilation.