Getting Started

This page covers the shortest path from a fresh clone to a running app. For full prerequisite details and alternative setup paths, see Installation.

Prerequisites, in short: PHP 8.5+, Node.js 22+, Composer, and a PostgreSQL database.

1. Clone the repository

git clone https://github.com/Promethys/ignite.git
cd ignite

2. Install dependencies

composer install
npm install

3. Set up your environment

cp .env.example .env
php artisan key:generate

4. Configure your database

Ignite uses PostgreSQL by default. Set the DB_* variables in .env and create the database. See Installation for connection details and Windows-specific notes.

5. Run migrations and seed

php artisan migrate --seed

This creates the schema and, local/dev only (never in production), a default admin account (admin@example.com / password).

6. Start the app

composer dev

This runs the Laravel server, the queue worker, and the Vite dev server concurrently. Visit http://localhost:8000.

Next steps

• Installation for detailed setup options and troubleshooting
• Configuration for environment variables and app settings
• Goal Types to learn how goals, entries, and milestones work