joepdooper/ivy

Yet another sleek simple fast CMS with an effortless template and plugin environment

dev-main 2025-09-14 12:05 UTC

Requires

• php: >=8.3.0
• joepdooper/ivy-roots: dev-main
• symfony/mime: ^7.3
• wixel/gump: ^2.2

Requires (Dev)

• joepdooper/ivy-cultivate: dev-main
• kint-php/kint: dev-master
• pestphp/pest: 3.x-dev
• phpstan/phpstan: 2.0.x-dev

MIT

• Joep Dooper

README

Yet another sleek simple fast CMS with an effortless template and plugin environment

Install

1. Navigate to your project folder

Open terminal and navigate to your project folder:

cd path/to/your/ivy/project

2. Download ivy files

Use Composer to create a new project with ivy:

composer create-project joepdooper/ivy .

3. Set up the database

Create a database for ivy and import the provided ivy.sql file:

mysql -u your_database_username -p your_database_name < ivy.sql

Rename the example.env file to .env and update it with your database credentials.

4. Set the document root

Make sure your web server points to the public/ folder inside this project.

<VirtualHost *:80>
    ServerName localhost
    DocumentRoot /var/www/public
    DirectoryIndex index.php index.html index.htm

    <Directory /var/www/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Login

Accessing the backend

To access the "backend" for the first time, after the installation, follow these steps:

1. Navigate to yourserver.com/admin/login (user icon)
2. Use the credentials [e-mail] and 00000
3. Upon successful login, you will be directed to the profile page with super_admin rights

Changing email and password

Open the .env file and update it with your mailbox credentials. If you've modified the .env file, follow these steps:

1. Upon login, on the profile page, modify and submit your email address to initiate the email change process
2. After successfully changing your email address, go to yourserver.com/admin/logout to log out (logout icon)
3. Finally, navigate to yourserver.com/admin/reset to initiate the password reset process

Documentation

Documentation coming up