Getting Started

Run NeNe Records locally in under 5 minutes.

Prerequisites

• Docker & Docker Compose
• Node.js 20+ (for the admin frontend)
• Git

1. Clone the repository

git clone https://github.com/hideyukiMORI/nene-records.git
cd nene-records

2. Configure environment

cp .env.example .env

Edit .env — at minimum set DB_PASSWORD and JWT_SECRET.

3. Start the stack

docker compose up -d

This starts:

• app — PHP 8.4 on http://localhost:8082
• mysql — MySQL 8.4 on localhost:3308
• phpmyadmin — http://localhost:8083
• mailpit — http://localhost:8026

4. Run migrations

docker compose exec app vendor/bin/phinx migrate

5. Start the frontend

cd frontend
npm install
npm run dev

6. Access

Default credentials

After migration, two users are seeded:

Verify everything works

# PHP checks (264 tests + PHPStan + CS-Fixer + OpenAPI + MCP)
composer check

# Frontend checks (type-check + lint + test + storybook)
npm run check --prefix frontend

Seed demo content

docker compose exec app php tools/seed-blog-demo.php http://localhost