Skip to content

RinCynar/SuisoruIX

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

69 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

SuisoruIX

SuisoruIX Logo

A beautiful Material You start page with powerful search capabilities

Vue Vite License

English ยท ็ฎ€ไฝ“ไธญๆ–‡

โœจ Features

  • ๐ŸŽจ Material You Design - Modern Material Design 3 aesthetics with dynamic colors and smooth animations
  • ๐Ÿ” Multi-Engine Search - Support for Google, Bing, Baidu, DuckDuckGo, Yandex, 360, Sogou, and custom engines
  • ๐ŸŒˆ Dynamic Wallpapers - Daily Bing wallpaper, random scenery, anime images, or custom backgrounds
  • โฐ Time & Weather - Real-time clock with weather information and lunar calendar support
  • ๐Ÿ”– Quick Shortcuts - Customizable website shortcuts for quick access
  • ๐Ÿ“ฑ Responsive Design - Perfect display on desktop, tablet, and mobile devices
  • ๐ŸŒ“ Dark Mode - Automatic theme switching with light and dark modes
  • ๐Ÿ’พ Data Persistence - Local storage of settings and shortcuts
  • ๐Ÿš€ PWA Support - Install as a progressive web app

๐Ÿ“ธ Screenshots

Desktop View

Desktop

Mobile View

Mobile

๐Ÿš€ Quick Start

Prerequisites

  • Node.js >= 16.0.0
  • pnpm (recommended) or npm

Installation

# Clone the repository
git clone https://github.com/RinCynar/SuisoruIX.git

# Navigate to project directory
cd SuisoruIX

# Install dependencies
pnpm install
# or
npm install

Development

# Start development server
pnpm dev
# or
npm run dev

The application will be available at http://localhost:5173

Build

# Build for production
pnpm build
# or
npm run build

# Preview production build
pnpm preview
# or
npm preview

โš™๏ธ Configuration

Create a .env file in the root directory to customize your settings:

# Site Information
VITE_SITE_TITLE = "SuisoruIX"
VITE_SITE_ANTHOR = "RinCynar"
VITE_SITE_KEYWORDS = "SuisoruIX,StartPage,RinCynar,SearchEngine"
VITE_SITE_DES = "StartPage"
VITE_SITE_LOGO = "/favicon.png"
VITE_SITE_APPLE_LOGO = "/logo/logo.png"
VITE_SITE_COPYRIGHTLINK = "https://rincynar.top"

# Welcome Text
VITE_WELCOME_TEXT = "Ciallo๏ฝž(โˆ ใƒปฯ‰< )โŒ’โ˜†"

# Search Input Placeholder
VITE_INPUT_TIP = "Search or type URL"

# ICP (Leave empty if not needed)
VITE_ICP = ""

# Weather API Key (Get from https://lbs.amap.com/)
VITE_WEATHER_KEY = ""

๐ŸŽจ Material You Design

This project has been refactored to follow Material Design 3 (Material You) guidelines:

  • Color System: Dynamic purple palette with proper surface containers
  • Typography: Prominent display text with proper hierarchy
  • Shapes: Rounded corners throughout (8px to 28px)
  • Motion: Smooth animations with standard easing curves
  • Elevation: Proper shadow system with glassmorphism effects

๐Ÿ› ๏ธ Technology Stack

Core

  • Vue 3 - Progressive JavaScript framework
  • Vite - Next generation frontend tooling
  • Pinia - State management
  • Sass - CSS preprocessor

UI Components

Utilities

๐Ÿ“ฆ Project Structure

SuisoruIX/
โ”œโ”€โ”€ public/              # Static assets
โ”‚   โ”œโ”€โ”€ background/      # Background images
โ”‚   โ”œโ”€โ”€ icon/           # Icons
โ”‚   โ””โ”€โ”€ lib/            # Icon fonts
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ api/            # API services
โ”‚   โ”œโ”€โ”€ assets/         # Project assets
โ”‚   โ”œโ”€โ”€ components/     # Vue components
โ”‚   โ”‚   โ”œโ”€โ”€ AllFunc/    # Main function components
โ”‚   โ”‚   โ””โ”€โ”€ SearchInput/ # Search components
โ”‚   โ”œโ”€โ”€ stores/         # Pinia stores
โ”‚   โ”œโ”€โ”€ style/          # Global styles
โ”‚   โ”œโ”€โ”€ utils/          # Utility functions
โ”‚   โ”œโ”€โ”€ App.vue         # Root component
โ”‚   โ””โ”€โ”€ main.js         # Entry point
โ”œโ”€โ”€ .env                # Environment variables
โ”œโ”€โ”€ index.html          # HTML template
โ”œโ”€โ”€ package.json        # Dependencies
โ””โ”€โ”€ vite.config.js      # Vite configuration

๐ŸŒŸ Features in Detail

Search Engines

  • Built-in Engines: Google, Bing, Baidu, DuckDuckGo, Yandex, 360, Sogou
  • Custom Engine: Add your own search engine URL
  • Search Suggestions: Real-time search suggestions (configurable)
  • Smart Detection: Automatically detect URLs and email addresses

Wallpapers

  • Local Default: Random default wallpapers
  • Daily Bing: Bing's daily featured image
  • Random Scenery: Beautiful landscape photos
  • Random Anime: Anime-style illustrations
  • Custom URL: Use your own image URL

Time & Weather

  • Multiple Clock Styles: Horizontal or vertical layout
  • 12/24 Hour Format: Choose your preferred time format
  • Seconds Display: Optional seconds display
  • Lunar Calendar: Traditional Chinese calendar
  • Weather Info: Real-time weather with temperature and wind

Customization

  • Theme: Light and dark mode
  • Search Box: Auto-collapse, auto-focus options
  • Wallpaper Effects: Blur and mask adjustments
  • Data Backup: Export and import your settings

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“„ License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

๐Ÿ“ง Contact

RinCynar - @RinCynar

Project Link: https://github.com/RinCynar/SuisoruIX


Made with โค๏ธ by RinCynar

About

Snavigation

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Vue 78.8%
  • JavaScript 12.9%
  • SCSS 7.4%
  • HTML 0.9%