README

Atomic Fullstack Framework for Modern PHP.

AtomPHP is an experimental, developer-focused fullstack framework built to explore modern PHP architecture through simplicity, performance, and strict design principles.

It is inspired by the developer experience of Nuxt.js and Next.js, but built entirely in PHP.

AtomPHP is not trying to replace Laravel. It is not trying to be a corporate enterprise framework.

It is a laboratory for building modern fullstack applications using:

File-based routing
SSR + SPA hybrid rendering
Strict typing
Clean architecture
Reusable UI components
Simple API building and integration
Security-first design
Developer experience as a priority

🎯 Vision

AtomPHP aims to bring a modern fullstack workflow to PHP:

One framework
One language
One codebase
Backend + Frontend together

Like Nuxt.js for Vue or Next.js for React — but purely in PHP.

The goal is to understand and experiment with:

Server-Side Rendering (SSR)
SPA-style hydration
File-based routing systems
Component-driven UI architecture
API-first design
Modern strict PHP architecture
Clean code and long-term maintainability

🧠 Why AtomPHP Exists

Modern frontend frameworks provide:

Automatic routing
Hybrid rendering
Component architecture
Clean DX

Traditional PHP frameworks focus heavily on backend structure but often separate frontend concerns.

AtomPHP explores the idea:

What if PHP handled both — cleanly and atomically?

This framework is built to experiment with:

Hybrid SSR + SPA flow
Minimal JavaScript footprint
Strong typing and static analysis friendliness
Future-proof structure
Secure-by-default architecture
Reusable atomic UI components

⚛ Core Philosophy

AtomPHP is built on atomic principles:

Small, composable pieces
Strict types everywhere
Clear boundaries between layers
Convention over configuration
Minimal magic
Security by design
Performance-aware architecture
Developer experience first

Every page, component, and API endpoint should feel like an independent atom — small, reusable, predictable.

🚀 What AtomPHP Wants to Build

AtomPHP aims to provide:

File-based routing (/pages/about.php → /about)
API auto-registration (/api/users.php → /api/users)
SSR rendering pipeline
SPA-style hydration layer
Typed request & response system
Component-based UI structure
Simple CLI tooling
Strict modern PHP (8.4+)
Clean internal kernel architecture

It is designed as:

A playground for architecture
A research project for modern PHP fullstack development
A learning tool for understanding how frameworks like Nuxt.js work internally

🧪 Experimental by Design

AtomPHP is intentionally:

Lightweight
Experimental
Educational
Architecture-focused

It values:

Code quality over feature bloat
Simplicity over complexity
Understanding over abstraction

🔐 Security & Code Quality

AtomPHP is built with:

Strict typing
Clear boundaries
Controlled data flow
Explicit rendering pipeline
Secure defaults

Security and maintainability are first-class concerns — not afterthoughts.

🌍 Long-Term Aim

The long-term aim of AtomPHP is to explore:

Can PHP provide a true modern fullstack DX?
Can SSR + SPA coexist cleanly in PHP?
Can file-based routing feel natural in backend-first development?
Can a minimal, atomic architecture scale cleanly?

AtomPHP is an experiment in answering those questions.

⚡ Status

Early-stage experimental framework. Built for exploration, learning, and modern architectural experimentation.

Build fullstack apps atomically.

atomphp / framework

Maintainers

Package info

Statistics

Security