Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 21 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,26 +3,27 @@
Whoami is a modern, self-hosted personal profile and portfolio platform built with **Rails 8**, **Hotwire**, and **Tailwind CSS**.
It lets you share your profile, links, CV/experience, and blog posts — all in a sleek, SEO-optimized interface.



---

## ✨ Features

- 🔐 **Authentication** with Devise (email confirmation included)
- 🎨 **Customizable profile** with name, avatar, bio, and links
- 🔗 **Favorite links** with real-time click tracking
- 📄 **Experience / CV** timeline
- 🔐 **Authentication** with Devise (email confirmation included)
- 🎨 **Customizable profile** with name, avatar, bio, and links
- 🔗 **Favorite links** with real-time click tracking
- 📄 **Experience / CV** timeline
- ✍️ **Blogging system** with rich text editor
- 📊 **Dashboard** with live stats (profile views, link clicks, blog reads)
- 🌍 **Public profiles** optimized for SEO (title/meta tags, slugs with FriendlyId)
- 📱 Fully responsive, modern UI with Tailwind and custom theme (dark + accent color)
- 📊 **Dashboard** with live stats (profile views, link clicks, blog reads)
- 🌍 **Public profiles** optimized for SEO (title/meta tags, slugs with FriendlyId)
- 📱 Fully responsive, modern UI with Tailwind and custom theme (dark + accent color)
- 📰 **RSS Feed** for every user’s blog posts (`/:username/feed`)
- 📧 **Newsletter subscriptions**: visitors can subscribe to your profile and get your published posts delivered automatically via email

---

## 🚀 Getting Started

### Prerequisites

- Ruby 3.4+
- Rails 8
- SQLite
Expand All @@ -31,22 +32,26 @@ It lets you share your profile, links, CV/experience, and blog posts — all in
### Setup

Clone the repository:

```bash
git clone https://github.com/YOUR_USERNAME/whoami.git
git clone https://github.com/s1lvax/whoami.git
cd whoami
```

Install dependencies:

```bash
bundle install
```

Setup the database:

```bash
bin/rails db:prepare
```

Run the server:

```bash
bin/dev
```
Expand All @@ -57,9 +62,10 @@ Visit: [http://localhost:3000](http://localhost:3000)

## 🖥️ Deployment

Whoami uses [Kamal](https://kamal-deploy.org) for zero-downtime Docker deployments.
Whoami uses [Kamal](https://kamal-deploy.org) for zero-downtime Docker deployments.

Deploy with:

```bash
bin/kamal deploy
```
Expand All @@ -78,9 +84,9 @@ bin/kamal deploy

## 📊 Stats Tracking

- Profile visits (ignores self and spammy repeat hits)
- Link clicks (safe + unique tracking)
- Blog post views
- Profile visits (ignores self and spammy repeat hits)
- Link clicks (safe + unique tracking)
- Blog post views

---

Expand All @@ -99,5 +105,4 @@ MIT License. See [LICENSE](LICENSE) for details.

## 👤 Author

Made with ❤️ by me (https://whoami.tech/cfds)

Made with ❤️ by me (<https://whoami.tech/cfds>)
Loading