sttp is a modern, customizable startpage designed to be used as a new tab in your browser.
Command palette, live search, customizable services, themes, and more — all in a beautiful glassmorphism UI.
Start typing to launch anything, instantly.
- ⌨️ Command Palette — press any key or
Ctrl+Kto launch. Type service names for autocomplete, or any text to search the web. Tab to fill suggestions, Enter to navigate - 🎨 Brand-Color Autocomplete — each suggestion is dynamically highlighted with the service's own brand color: background tint, left border, and text color. Instantly recognize your services
- 🔍 Search Engine Selector — pick your default from Google, DuckDuckGo, Bing, Brave, Yahoo, Ecosia, Startpage — or add your own custom search engines with emoji, label, and URL template
- 📦 Service Manager — add, edit, and delete your own web services with custom icons (emoji, react-icons, SVGR, or images), colors, and URL patterns. All saved to localStorage
- 🎯 12 Accent Targets — dedicated Accent tab with granular control over which UI elements use your accent color: clock digits, colon separator, date text, icons, tabs, toggles, sliders, focus ring, scrollbar, glass borders, button borders, and text cursor
- 🎨 Accent Color Picker — choose from 10 preset accent colors or pick any custom color. Applies instantly across the entire UI
- 📋 Settings Profiles — save your entire settings configuration as a named profile. Set a startup default that loads on every visit. Export all profiles as JSON, import profiles from other devices. Factory default is always available
- 🌓 Light / Dark Theme — toggle instantly via CSS variables with a floating button. No page reload needed
- 🪟 Glassmorphism UI — adjustable glass intensity (light, medium, strong). Background dim and blur when palette opens
- ⏰ Customizable Clock — 12h/24h, show/hide seconds, auto-hide on typing, independent font size from 3rem to 8rem
- 📅 Flexible Date Display — 12+ locales, 4 format styles, toggle day-of-week, year, capitalization. Independent font size from 0.5rem to 3rem
- 📱 Mobile Optimized — floating palette trigger button, swipe-down gesture to open palette, responsive layout that adapts to any screen size
- 🖱️ Draggable Settings Tabs — click and drag the tab bar horizontally with your mouse. Touch scrolling also works on mobile. All 7 tabs always reachable
- 👋 Welcome Tour — interactive 8-step tour shown every startup. Check "Don't show again" to permanently dismiss. Replay anytime via Settings → View tour
- ♿ Accessible — keyboard navigation, focus rings, ARIA labels, screen-reader friendly
git clone https://github.com/mohvn/sttp.git
cd sttp
yarn install
yarn devOpen http://localhost:5173 in your browser.
| Command | Description |
|---|---|
yarn dev |
Start development server with HMR |
yarn build |
Type-check and production build |
yarn test |
Run all tests (Vitest) |
yarn test:watch |
Run tests in watch mode |
yarn lint |
Lint with ESLint |
yarn preview |
Preview production build locally |
yarn deploy |
Deploy dist/ to gh-pages branch |
src/
├── components/ # Shared UI components (Clock, DateDisplay, Icon, TextHighlight)
├── features/ # Domain modules (atomic design)
│ ├── CommandPalette/ # Palette input, autocomplete, overlay, keyboard handling
│ ├── Settings/ # Theme, accent (12 targets), profiles, search, services, clock, date
│ └── WelcomeTour/ # Interactive 8-step tour with "Don't show again"
├── hooks/ # Global reusable hooks
├── types/ # Global type definitions (Service)
├── utils/ # Pure utility functions (parseInput, url, keyboard)
└── App.tsx # Root layout + global accent CSS effect
Atomic Design combined with Bulletproof React principles:
src/
├── components/
│ ├── atoms/ # Button, Input, Label, Badge...
│ ├── molecules/ # FormField, SearchBar, Card...
│ ├── organisms/ # Header, Sidebar, DataTable...
│ └── templates/ # PageLayout, AuthLayout...
├── features/ # Domain modules
│ └── [feature]/
│ ├── components/
│ ├── hooks/
│ ├── types/
│ └── index.ts
├── hooks/ # Global reusable hooks
├── lib/ # Library configurations
├── pages/ # Routes (template + feature composition)
├── types/ # Global types
└── utils/ # Pure utility functions
- Open Settings → Search
- Click "Add custom search engine"
- Enter a label (e.g., "My Search"), URL template with
%sfor the query (e.g.,https://mysite.com/search?q=%s), and an emoji icon - Click to select it as your default
- Open Settings → Services
- Click "Add"
- Enter an identifier key, display name, home URL, and colors
- The service will appear in the command palette autocomplete
- Open Settings → Appearance
- Click any preset color or use the custom color picker
- The accent color updates instantly across all 12 target elements
- Open Settings → Accent
- Toggle any of the 12 accent targets independently:
- Clock & Time: clock digits, colon separator, text cursor
- Date: date text
- Navigation: interface icons, active tab underline
- Interactive: toggle switches, range sliders, focus ring, button borders
- Surface: scrollbar thumb, glass panel borders
- Changes apply immediately
- Open Settings → Profiles
- Click "Save current settings as profile" and give it a name
- Click the star icon to set any profile as your startup default — it loads automatically every time you visit
- Use the Load button to switch configurations on the fly
- The built-in "Default (factory)" profile is always available and can't be deleted
- Export all user profiles as JSON or import profiles from other devices
| Setting | Location | Options |
|---|---|---|
| Theme | Appearance | Dark / Light |
| Accent Color | Appearance | 10 presets + custom color picker |
| Accent Targets (12) | Accent | Clock digits, colon, date, icons, tabs, toggles, sliders, focus ring, scrollbar, glass border, button border, caret |
| Glass Intensity | Appearance | Light / Medium / Strong |
| Background Dim | Appearance | 0–80% + auto blur |
| Settings Profiles | Profiles | Save / Load / Delete / Export / Import / Startup default |
| Default Search Engine | Search | 7 built-in + custom |
| User Search Engines | Search | Add / Edit / Delete |
| User Services | Services | Add / Edit / Delete |
| Clock Format | Clock | 12h / 24h, seconds, auto-hide, font size (3–8rem) |
| Date Format | Date | 12+ locales, 4 styles, day/year/caps, font size (0.5–3rem) |
| Tab Navigation | Settings tabs | Drag-to-scroll (mouse) + touch scroll + scrollbar (desktop) |
| Welcome Tour | Startup (or Settings → View tour) | 8-step tour, brand colors, "Don't show again", startup defaults |
| Layer | Technology |
|---|---|
| Framework | React 19 |
| Language | TypeScript 6 |
| Build Tool | Vite 8 |
| Styling | Tailwind CSS 4 |
| State | Zustand 5 |
| Validation | Zod 3 |
| Testing | Vitest 4 |
| Linting | ESLint 10 |
| Icons | React Icons |
| Hosting | GitHub Pages |
- Lazy loaded Settings panel (45 kB separate chunk)
- All leaf components wrapped with
React.memo - Zustand selectors optimized to prevent cascade re-renders
parseInputcall deduplicated — computed once per keystroke in parent- Icon component uses direct JSX rendering instead of
createElement - CSS minimal — only used keyframes and utilities retained
- Production bundle: ~113 kB gzipped (main) + 10 kB (SettingsPanel)
Every push to main triggers an automatic deployment to GitHub Pages via the provided workflow.
made with ❤️