A public showcase (and eventual multi-tenant platform) for a universal index of immutable things.
Built on Laravel 12, Livewire v3, Alpine.js, and Tailwind CSS.

index.one aims to provide a human‑readable landing page for every immutable Thing—elements, compounds, standards, etc.—and their relationships, at a fixed, semantically meaningful URL.

For detailed fields and indexes, see docs/index-one-model-manifest.md.

Planned but deferred: Tagging, Revision history, Fine‑grained ACL.

• Provide a dashboard for everything, at a meaningful URL
• Useful core information for each as well as hyperlinks to other commonly used services. A table of contents.

• minimalistic and utilitarian
• inspiration: GUIs from Deus Ex: Mankind Divided and Cyberpunk 2077
• triangles and hexagons

Substances, ingredients, materials, products

• an index of all chemical elements and molecules
• a GPS-aware asset scanner based on QR. Assets are scanned to GPS coordinates, and then to addresses and sub-buildings, rooms, containers. blockchain based tracking?
• deployable as a self-hosted application - name your universe, name your scope. integrate all of your company systems into a single interface
• URL design: https://index.ayoung.co/element/sodium, https://index.ayoung.co/organization/Dell

• [Ownerly, similar use case](https://www.instagram.com/useownerly?igsh=N2hpZ2VxaTNpZmIw

• PHP 8.3+ with BCMath & PDO extensions
• Node 18+ & PNPM/Yarn
• MySQL 8 / MariaDB 10.6+
• Composer 2.7+
  (or simply docker compose up -d with Laravel Sail)

git clone https://github.com/your-org/index.one.git
cd index.one

# PHP dependencies
composer install

# JS & CSS
pnpm install && pnpm run dev   # or yarn / npm

# Copy env and generate key
cp .env.example .env
php artisan key:generate

Edit .env for database credentials:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=index_one
DB_USERNAME=root
DB_PASSWORD=secret

Optional: Set an index alias for the php artisan command to simplify usage:

# ~/.bashrc  or  ~/.zshrc
index () {
    php /var/www/index/artisan "$@"
}

php artisan migrate
php artisan db:seed --class=RelationTypeSeeder   # seeds is_a, part_of, etc.

# Start dev server
php artisan serve

# Livewire hot‑reloading
pnpm run dev   # Vite

# Run test suite
php artisan test          # PHPUnit
# or
pest                      # if Pest installed

Visit http://localhost:8000.

1. Fork the repo & create a branch (git checkout -b feature/my-awesome-thing)
2. Commit with semantic‑release style commits
3. Push & open a PR describing what and why
4. Ensure tests pass (php artisan test) and add new tests when reasonable

Code released under the MIT License unless noted otherwise.
© 2025 index.one contributors