A web application for instantly generating unique, random, and aesthetically pleasing minimalist gradient avatars from any text input. This project provides high-quality, reproducible avatars perfect for profile pictures, applications, and placeholder images.
- Deterministic Generation: Consistently generates the same avatar for the same text input, ensuring reproducibility.
- Instant Preview: See the generated avatar update in real-time as you type.
- Minimalist Design: A clean, modern, and user-friendly interface.
- Theme Support: Seamlessly switch between light and dark modes for optimal viewing comfort.
- Built with SvelteKit: Leverages the power of SvelteKit for a fast, modern, and scalable web experience.
This project is built with a modern, efficient, and developer-friendly technology stack.
| Technology | Description |
|---|---|
| SvelteKit | A framework for building robust, high-performance web applications. |
| Tailwind CSS | A utility-first CSS framework for rapid UI development. |
| TypeScript | A typed superset of JavaScript that enhances code quality and maintainability. |
| shadcn-svelte | Re-usable components built using Svelte and Tailwind CSS for a consistent design. |
| bits-ui | A collection of headless, unstyled Svelte components for building accessible UIs. |
| Lucide | A beautiful and consistent icon toolkit. |
| Vite | A next-generation frontend build tool that provides a fast development experience. |
To get a local copy up and running, please follow these simple steps.
-
Clone the repository
git clone https://github.com/treasureuzoma/avatar.git
-
Navigate to the project directory
cd avatar -
Install dependencies This project uses
pnpmas the package manager.pnpm install
Once the installation is complete, you can run the development server.
-
Start the development server
pnpm run dev
-
Open in browser Open your browser and navigate to
http://localhost:5173to see the application in action.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
