Svelte MiniApps (Svelte 5 Edition)

Boost your productivity with Svelte MiniApps - a collection of user-friendly tools rebuilt with Svelte 5 for enhanced speed and reliability!

Svelte MiniApps is a collection of small, single-purpose applications designed for simplicity and efficiency. Originally a personal project to learn full-stack development, it has evolved into a repository of handy tools for various tasks. This version has been updated to Svelte 5 to fully leverage its speed and resolve build errors encountered during auto migration.

Table of Contents

• About 📝
• Built for Efficiency 🛠️
• Getting Started 🏁
• List of Apps 📋
• Contributing 🤝
• License 📄
• Old Version 🔙

About

Svelte MiniApps offers tools to streamline specific tasks. Whether converting units, generating passwords, or managing to-do lists, there's a mini-app to simplify your day.

Built for Efficiency

Svelte MiniApps is a single Progressive Web App (PWA) featuring a collection of tools built for various web users. It enhances productivity and organization with the following features:

• Versatile Tools: Designed for different needs and difficulty levels.
• Web-Based: Built specifically for web users.
• High Performance: Fast and efficient, now with Svelte 5.
• Installable: Can be added to your device for quick access.
• Offline Capability: Works offline once accessed.

Getting Started

Prerequisites:

• Node.js and npm (or another package manager).
• PostgreSQL database (for production)

Database Setup: The project uses Prisma ORM for database management. Follow these steps to set up your database:

1. Copy the example environment file:

cp .env.example .env

2. Update the DATABASE_URL in your .env file:

DATABASE_URL="postgresql://user:password@localhost:5432/dbname"

3. Initialize your database:

npx prisma generate  # Generate Prisma Client
npx prisma db push   # Push schema changes to database

For development, you can use Prisma Studio to manage your data:

npm run db:studio

Explore the Mini-Apps: Clone the repository and run the development server to explore the mini-apps.

git clone https://github.com/Michael-Obele/Svelte-MiniApps.git
cd Svelte-MiniApps
bun install
bun run dev

Note: The Vite development server runs on port 5178 instead of the traditional 5173. Make sure to access your app at http://localhost:5178.

Important: For production environments, it's recommended to switch your Prisma data source provider from SQLite to PostgreSQL or MySQL.

Database ORM

The project uses Prisma ORM for database management. Prisma provides type-safe database access with great developer experience.

This will launch a local server and open the mini-apps in your browser.

Installable

Install Svelte MiniApps as standalone applications for quick access:

1. Open the mini-app in your browser.
2. Click on the browser's menu (three dots).
3. Select "Install" or "Add to Home Screen."

Live Version

Access the live version at: Svelte MiniApps

List of Apps

Explore the full list of mini-apps designed to boost your productivity. Visit svelte-apps.me/#apps for details.

Contributing

We welcome contributions! Fork the repository, make your changes, and submit a pull request.

Guidelines:

• Single-purpose tools: Each mini-app should focus on a specific task.
• User-friendly: Ensure the mini-app is easy to use with clear instructions.
• Clean code: Follow Svelte best practices and keep code organized.

Old Version

For those interested in the previous version of Svelte MiniApps, it is available at the following repository:

• Svelte MiniApps v4: Svelte-MiniApps-sv4

This version is located at sv4.svelte-apps and contains the earlier implementations of the mini-apps, built with Svelte 4. Users may explore this version for reference or migration purposes.

License

This project is licensed under the MIT License.

• You can freely use, modify, and distribute this software.
• You must retain the copyright and license notice in all copies.
• The full license text is in the LICENSE file in the repository.