Ashdeck turns every new tab into a calm, distraction-free focus space. Instead of opening a blank page (or your last open tab), every new tab becomes a personal dashboard with a built-in Pomodoro timer, a site blocker for distracting websites, a simple task list, and ambient focus soundscapes — all in one place, all free, all open source.

No separate app to switch to. No browser extension you forget exists. Just open a new tab, and your focus tools are already there, waiting.

• 🆓 100% free — no premium tier, no paywalled features
• 🔓 Fully open source under AGPL-3.0 — inspect it, fork it, self-host it
• ⚡ Lightweight — built with React, TypeScript, and Vite
• 🧩 Zero setup — install from the Chrome Web Store and it just works

• Features
• Install Ashdeck (for users)
• Run Ashdeck locally (for developers)
• Tech Stack
• Project Structure
• Roadmap
• Contributing
• Community & Support
• License

The easiest way to use Ashdeck is to install it directly from the Chrome Web Store:

1. Click Add to Chrome
2. Open a new tab
3. Your Pomodoro timer, site blocker, task list, and focus dashboard are ready to go — no account, no setup

Currently available for Chrome and Chromium-based browsers (Brave, Edge, etc. via the Chrome Web Store).

Want to contribute, customize, or self-host Ashdeck? Here's how to get a local development environment running.

• Node.js (v18 or later recommended)
• npm (comes with Node.js)

# 1. Clone the repository
git clone https://github.com/ashdeck/ashdeck.git
cd ashdeck

# 2. Install dependencies
npm install

# 3. Start the development server
npm run dev

The app will be available locally — open it in your browser to start developing.

1. Run npm run build to generate a production build
2. Open chrome://extensions in Chrome
3. Enable Developer mode (top right)
4. Click Load unpacked and select the build output folder
5. Open a new tab to see your local build of the Ashdeck new tab dashboard

💡 New here? Check out our CONTRIBUTING.md for a full walkthrough of the codebase and how to make your first contribution.

Ashdeck is built with a modern, lightweight frontend stack:

• React + TypeScript + Vite — core framework and build tooling
• Zustand — lightweight state management
• TanStack Query — data fetching and caching
• React Hook Form — form handling
• Axios — HTTP requests
• React Hot Toast — notifications/toasts
• IconSax — icon set
• Generouted — file-based routing (Next.js-style routing for React + Vite)

Ashdeck uses a file-based router (via Generouted) to keep the codebase organized in a way that should feel familiar if you've worked with Next.js.

src/
├── components/     # Reusable UI components (CustomButton, FormInput, etc.)
├── store/          # Zustand stores for global state
├── pages/          # File-based routes (Generouted)
├── hooks/          # Custom React hooks
└── ...

A few things worth knowing before you dive in:

• CustomButton and FormInput are ready-made components — FormInput is designed to work with React Hook Form out of the box.
• Global state lives in store/ using Zustand — check there before adding new state management.
• Routing follows the Generouted convention — new pages just need to be added to the pages/ directory.

• Firefox / Edge add-on store listings
• Customizable focus soundscape mixing
• Site blocker scheduling (recurring focus hours)
• Sync settings across devices
• Dark mode themes

Have an idea? Open a feature request — we'd love to hear it.

Ashdeck is built in the open, and contributions of all sizes are welcome — from fixing a typo to building a whole new feature.

• 🟢 New to the project? Look for issues labeled good first issue
• 🐛 Found a bug? Open an issue
• 💡 Have a feature idea? Open a feature request
• 📖 Read CONTRIBUTING.md for setup details and our PR process
• 🤝 Please follow our CODE_OF_CONDUCT.md

Every star, issue, and pull request helps Ashdeck grow — thank you for being part of it. ⭐

• 🌐 ashdeck.com
• 🐦 Follow updates and share what you're building with Ashdeck
• 🗳️ GitHub Discussions — introduce yourself, request features, or show off your setup

Ashdeck is open source under the AGPL-3.0 License.