diff --git a/resources/views/components/footer.blade.php b/resources/views/components/footer.blade.php index 416e8c46..e9c9f55c 100644 --- a/resources/views/components/footer.blade.php +++ b/resources/views/components/footer.blade.php @@ -96,6 +96,7 @@ class="flex flex-wrap items-center justify-center gap-2.5 *:opacity-0" > {{-- Decorative circle --}} diff --git a/resources/views/components/social-networks-all.blade.php b/resources/views/components/social-networks-all.blade.php index 99de0672..76733ddf 100644 --- a/resources/views/components/social-networks-all.blade.php +++ b/resources/views/components/social-networks-all.blade.php @@ -1,6 +1,7 @@
@@ -13,6 +14,7 @@ class="size-[1.1rem] text-black transition duration-200 group-hover:text-violet-
@@ -25,6 +27,7 @@ class="size-[1.4rem] text-black transition duration-200 group-hover:text-violet-
@@ -36,7 +39,8 @@ class="size-[1.1rem] text-black transition duration-200 group-hover:text-violet-
@@ -48,7 +52,8 @@ class="size-[1.1rem] text-black transition duration-200 group-hover:text-violet-
@@ -60,7 +65,8 @@ class="size-[1.1rem] text-black transition duration-200 group-hover:text-violet-
@@ -73,6 +79,7 @@ class="size-[1.1rem] transition duration-200 group-hover:fill-violet-400 dark:fi
@@ -85,6 +92,7 @@ class="size-[1.6rem] text-black transition duration-200 group-hover:text-violet-
diff --git a/resources/views/components/sponsors/lists/home/corporate-sponsors.blade.php b/resources/views/components/sponsors/lists/home/corporate-sponsors.blade.php index d828a3c7..819d8281 100644 --- a/resources/views/components/sponsors/lists/home/corporate-sponsors.blade.php +++ b/resources/views/components/sponsors/lists/home/corporate-sponsors.blade.php @@ -4,6 +4,7 @@ class="opacity-0" > Job. Any queued jobs that don't get processed before your app is quit, will get processed when your application (and the queue runner) starts again. @@ -50,7 +50,7 @@ queue runner) starts again. ### Scheduler The Laravel scheduler runs as normal (every minute) inside a NativePHP application. You can add -[scheduled tasks](https://laravel.com/docs/scheduling) to your application just as you normally would, to have them run +scheduled tasks to your application just as you normally would, to have them run on a regular schedule. Any scheduled tasks that would have run while your application isn't running will be skipped. @@ -62,9 +62,9 @@ only be able to run while your application is running.** PHP has good built-in support for running arbitrary programs in separate processes. For example: -- [`shell_exec`](https://www.php.net/manual/en/function.shell-exec.php) allows you to run commands and return their +- `shell_exec` allows you to run commands and return their output to your application. -- [`proc_open`](https://www.php.net/manual/en/function.proc-open.php) allows you to spin up a command with more control +- `proc_open` allows you to spin up a command with more control over how its input and output streams are handled. While these can be used in your NativePHP application, consider that they: @@ -120,7 +120,7 @@ ChildProcess::start( ### Persistent Processes You may mark a process as `persistent` to indicate that the runtime should make sure that once it has been started it -is always running. This works similarly to tools like [`supervisord`](http://supervisord.org/), ensuring that the +is always running. This works similarly to tools like `supervisord`, ensuring that the process gets booted up again in case it crashes. ```php diff --git a/resources/views/docs/desktop/1/digging-deeper/databases.md b/resources/views/docs/desktop/1/digging-deeper/databases.md index 1ab36a3b..5eb558ca 100644 --- a/resources/views/docs/desktop/1/digging-deeper/databases.md +++ b/resources/views/docs/desktop/1/digging-deeper/databases.md @@ -20,7 +20,7 @@ You can interact with SQLite via PDO or an ORM, such as Eloquent, in exactly the ## SQLite -[SQLite](https://sqlite.org/) is a feature-rich, portable, lightweight, file-based database. It's perfect for native +SQLite is a feature-rich, portable, lightweight, file-based database. It's perfect for native applications that need persistent storage of complex data structures with the speed and tooling of SQL. Its small footprint and minimal dependencies make it ideal for cross-platform, native applications. Your users @@ -48,7 +48,7 @@ it doesn't modify any other SQLite databases you may already be using. When writing migrations, you need to consider any special recommendations for working with SQLite. For example, prior to Laravel 11, SQLite foreign key constraints are turned off by default. If your application relies -upon foreign key constraints, [you need to enable SQLite support for them](https://laravel.com/docs/database#configuration) before running your migrations. +upon foreign key constraints, you need to enable SQLite support for them before running your migrations. **It's important to test your migrations on prod builds before releasing updates!** You don't want to accidentally delete your user's data when they update your app. @@ -83,7 +83,7 @@ php artisan native:migrate:fresh ## Seeding When developing, it's especially useful to seed your database with sample data. If you've set up -[Database Seeders](https://laravel.com/docs/seeding), you can run these using the `native:db:seed` command: +Database Seeders, you can run these using the `native:db:seed` command: ```shell php artisan native:db:seed diff --git a/resources/views/docs/desktop/1/digging-deeper/files.md b/resources/views/docs/desktop/1/digging-deeper/files.md index 8c5fbc70..3d1cb458 100644 --- a/resources/views/docs/desktop/1/digging-deeper/files.md +++ b/resources/views/docs/desktop/1/digging-deeper/files.md @@ -7,7 +7,7 @@ order: 300 Working with files in NativePHP is just like working with files in a regular Laravel application. To achieve this, NativePHP rewrites the `Application::$storagePath()` (and thus `app()->storagePath()` and the `storage_path()` helper) -to the [Electron `app.getPath('appData')` path](https://www.electronjs.org/docs/latest/api/app#appgetpathname), +to the Electron `app.getPath('appData')` path, which is different for each operating system. This means that you can continue to use Laravel's `Storage` facade to store and retrieve files on your user's file @@ -31,7 +31,7 @@ It's also the location where your SQLite database will be stored. ### Storing files elsewhere NativePHP doesn't interfere with any of your _existing_ filesystem configuration, so you may continue to configure -[Filesystem](https://laravel.com/docs/filesystem) as you normally would, however you should be aware that it does +Filesystem as you normally would, however you should be aware that it does _add_ some new default filesystems for your convenience. Consider that your users want to store their files in locations other than the obscure `appdata` directories on their diff --git a/resources/views/docs/desktop/1/digging-deeper/php-binaries.md b/resources/views/docs/desktop/1/digging-deeper/php-binaries.md index aad2cc0d..bed31866 100644 --- a/resources/views/docs/desktop/1/digging-deeper/php-binaries.md +++ b/resources/views/docs/desktop/1/digging-deeper/php-binaries.md @@ -24,14 +24,14 @@ On top of this, fewer PHP extensions means a smaller application size and attack extensions has both performance & [security](security) implications for your apps. The extensions that are included in the default binaries are defined in the -[`php-extensions.txt`](https://github.com/NativePHP/php-bin/blob/main/php-extensions.txt) in the `php-bin` repo. +`php-extensions.txt` in the `php-bin` repo. If you think an extension is missing that would make sense as a default extension, feel free to -[make a feature request](https://github.com/nativephp/laravel/issues/new/choose) for it. +make a feature request for it. ## Building custom binaries -NativePHP uses the awesome [`static-php-cli`](https://static-php.dev/) library to build distributable PHP binaries. +NativePHP uses the awesome `static-php-cli` library to build distributable PHP binaries. You may use this too to build your own binaries. Of course, you may build static binaries however you prefer. diff --git a/resources/views/docs/desktop/1/digging-deeper/queues.md b/resources/views/docs/desktop/1/digging-deeper/queues.md index 77d9e5ca..6f2a0e90 100644 --- a/resources/views/docs/desktop/1/digging-deeper/queues.md +++ b/resources/views/docs/desktop/1/digging-deeper/queues.md @@ -6,7 +6,7 @@ order: 500 Queueing tasks to be run in the background is a critical part of creating a great user experience. -NativePHP has built-in support for Laravel's [Queues](https://laravel.com/docs/queues). +NativePHP has built-in support for Laravel's Queues. ## Queueing a job If you're familiar with queueing jobs in Laravel, you should feel right at home. There's nothing special you need to do. diff --git a/resources/views/docs/desktop/1/getting-started/debugging.md b/resources/views/docs/desktop/1/getting-started/debugging.md index 0090270e..2fae0952 100644 --- a/resources/views/docs/desktop/1/getting-started/debugging.md +++ b/resources/views/docs/desktop/1/getting-started/debugging.md @@ -135,9 +135,9 @@ C:\path\to\your\app\dist\win-unpacked\resources\app.asar.unpacked\resources\php\ ``` ## Still stuck? -If you've found a bug, please [open an issue](https://github.com/nativephp/laravel/issues/new) on GitHub. +If you've found a bug, please open an issue on GitHub. -There's also [Discussions](https://github.com/orgs/NativePHP/discussions) and -[Discord](https://discord.gg/X62tWNStZK) for live chat. +There's also Discussions and +[Discord](/discord) for live chat. Come join us! We want you to succeed. diff --git a/resources/views/docs/desktop/1/getting-started/development.md b/resources/views/docs/desktop/1/getting-started/development.md index 67d55e89..6197d0b3 100644 --- a/resources/views/docs/desktop/1/getting-started/development.md +++ b/resources/views/docs/desktop/1/getting-started/development.md @@ -44,7 +44,7 @@ supports hot reloading of certain files within its core and your application, bu source code for changes. It is left to you to determine how you want to approach this. If you're using Vite, hot reloading will just work inside your app as long as you've booted your Vite dev server and -[included the Vite script tag](https://laravel.com/docs/vite#loading-your-scripts-and-styles) in your views +included the Vite script tag in your views (ideally in your app's main layout file). You can do this easily in Blade using the `@@vite` directive. diff --git a/resources/views/docs/desktop/1/getting-started/installation.md b/resources/views/docs/desktop/1/getting-started/installation.md index 513326a4..e3aac5ab 100644 --- a/resources/views/docs/desktop/1/getting-started/installation.md +++ b/resources/views/docs/desktop/1/getting-started/installation.md @@ -15,7 +15,7 @@ order: 100 The best development experience for NativePHP is to have PHP and Node running on your development machine directly. If you're using Mac or Windows, the most painless way to get PHP and Node up and running on your system is with -[Laravel Herd](https://herd.laravel.com). It's fast and free! +Laravel Herd. It's fast and free! Please note that, whilst it's possible to develop and run your application from a virtualized environment or container, you may encounter more unexpected issues and have more manual steps to create working builds. @@ -23,7 +23,7 @@ you may encounter more unexpected issues and have more manual steps to create wo ### Laravel NativePHP is built to work best with Laravel. You can install it into an existing Laravel application, or -[start a new one](https://laravel.com/docs/installation). +start a new one. ## Install a NativePHP runtime diff --git a/resources/views/docs/desktop/1/getting-started/introduction.md b/resources/views/docs/desktop/1/getting-started/introduction.md index d73cdb9c..d77a6289 100644 --- a/resources/views/docs/desktop/1/getting-started/introduction.md +++ b/resources/views/docs/desktop/1/getting-started/introduction.md @@ -72,14 +72,14 @@ that puts cowboy hats on every smiley-face emoji it sees. (You should totally build that last one.) -Need some inspiration? [Check out our repository of awesome projects](https://github.com/NativePHP/awesome-nativephp) created by people like you! +Need some inspiration? Check out our repository of awesome projects created by people like you! ## What's next? Go read the docs! We've tried to make them as comprehensive as possible, but if you find something missing, please -feel free to [contribute](https://github.com/nativephp/nativephp.com). +feel free to contribute. -This site and all the NativePHP for Desktop repositories are open source and available on [GitHub](https://github.com/nativephp). +This site and all the NativePHP for Desktop repositories are open source and available on GitHub. Ready to jump in? [Let's get started](installation). @@ -87,9 +87,9 @@ Ready to jump in? [Let's get started](installation). NativePHP wouldn't be possible without the following projects and the hard work of all of their wonderful contributors: -- [PHP](https://php.net) -- [Electron](https://electronjs.org) -- [Tauri](https://tauri.app) -- [Laravel](https://laravel.com) -- [Symfony](https://symfony.com) -- [Static PHP CLI](https://github.com/crazywhalecc/static-php-cli/) +- PHP +- Electron +- Tauri +- Laravel +- Symfony +- Static PHP CLI diff --git a/resources/views/docs/desktop/1/getting-started/status.md b/resources/views/docs/desktop/1/getting-started/status.md index 01c7f4b8..65a04ac6 100644 --- a/resources/views/docs/desktop/1/getting-started/status.md +++ b/resources/views/docs/desktop/1/getting-started/status.md @@ -13,9 +13,9 @@ NativePHP for Desktop is **production-ready**. So you should feel completely rea with NativePHP. But we always need your help! If you spot any bugs or feel that there are any features missing, be sure to share -your ideas and questions through the [forum](https://github.com/orgs/nativephp/discussions), by -[raising issues](https://github.com/nativephp/laravel/issues/new/choose)/reporting bugs, and discussing on -[Discord](https://discord.gg/X62tWNStZK). +your ideas and questions through the forum, by +raising issues/reporting bugs, and discussing on +[Discord](/discord).