🔗 Biolinks

Biolinks is a powerful, self-hosted implementation of a "link-in-bio" solution. Built with the latest Laravel technologies, it offers a robust platform for managing personal and professional links with a modern, high-performance architecture.

✨ Features

• 🔗 Link Management: Create, edit, and reorganize your links with ease.
• 🎨 Customization: Modern UI built with TailwindCSS v4.
• ⚡ High Performance: Powered by Laravel 12 and Vite 7 for lightning-fast loads.
• 🛡️ Robust Auth: Secure user authentication and session management.
• 📱 Mobile First: Fully responsive design optimized for all devices.
• 🧪 Quality Assured: Comprehensive testing with Pest and static analysis with Pint.

🚀 Getting Started

Prerequisites

• PHP 8.2+
• Composer
• Node.js & NPM

Installation

1. Clone the repository:

   git clone https://github.com/rafaumeu/biolinks.git
   cd biolinks

2. Environment Setup: Copy the example environment file and generate your encryption key:

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

3. Install dependencies:

   composer install
   npm install

4. Database & Migrations: Setup your database in .env and run migrations:

   php artisan migrate

5. Run Application: Start the development server:

   composer run dev

   Access at http://localhost:8000.

🛠️ Tech Stack

• Framework: Laravel 12.x
• Language: PHP 8.2+
• Frontend: Blade, TailwindCSS 4, Vite 7
• Testing: Pest PHP
• Tooling: Laravel Pint, Larastan

📂 Project Structure

biolinks/
├── app/                # Application Core Code
│   ├── Http/           # Controllers & Middleware
│   └── Models/         # Eloquent Models
├── bootstrap/          # Framework Bootstrap
├── config/             # Application Configuration
├── database/           # Migrations & Factories
├── public/             # Web Entry Point
├── resources/          # Views & Assets (CSS/JS)
├── routes/             # Web & API Routes
├── storage/            # Logs & Compiled Blade Views
├── tests/              # Pest Tests
└── vendor/             # Composer Dependencies

🤝 Contributing

We strictly follow the GitHub Flow.

1. Fork the project.
2. Create your feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes following Conventional Commits (feat: add new theme support).
4. Push to the branch.
5. Open a Pull Request.

👨💻 Author

Made with 💜 by Rafael Dias Zendron