DevOne

DevOne is a self-hosted developer workspace that connects project work, Git activity, databases, APIs, documentation, and deployments in one project context.

Current MVP

• Next.js 16 and React 19
• TypeScript and Tailwind CSS 4
• shadcn/ui dashboard shell
• GitHub and GitLab personal access token login
• Encrypted provider credentials and database-backed HttpOnly sessions
• PostgreSQL-backed projects and live dashboard counts
• Login throttling and self-hosted GitLab host allowlisting
• Theme support and production Dockerfiles
• Docker Compose with PostgreSQL and Redis

Tech stack

See docs/tech-stack.md for every framework, library and service DevOne uses.

Development

bun install
cp env.example.txt .env
# Set both database URLs and POSTGRES_PASSWORD, then generate DEVONE_ENCRYPTION_KEY with:
# openssl rand -base64 32
docker compose up -d postgres redis
bun run db:deploy
bun run dev

Open http://localhost:3000.

Checks

bun run test
bun run test:db
bun run lint:strict
bun run typecheck
bun run build

Self-hosting

DevOne ships as ready-made Docker images, ghcr.io/imnotseanwtf/devone and ghcr.io/imnotseanwtf/devone-migrate, with PostgreSQL and Redis in the Compose stack.

# 1. Get the code
git clone https://github.com/imnotseanwtf/devone
cd devone
# 2. Copy the example environment
cp env.example.txt .env
# 3. Set a database password and encryption key, and let the first sign-in become administrator
perl -pi -e "s/change-me/$(openssl rand -hex 16)/g; \
  s|^DEVONE_ENCRYPTION_KEY=.*|DEVONE_ENCRYPTION_KEY=$(openssl rand -base64 32)|; \
  s/^DEVONE_ALLOW_BOOTSTRAP=.*/DEVONE_ALLOW_BOOTSTRAP=true/" .env
# 4. Start the stack
docker compose pull
docker compose up -d

Step 3 fills the placeholders in .env: one random password for PostgreSQL and both database URLs (hex, so it needs no URL-encoding), a new DEVONE_ENCRYPTION_KEY (back it up: losing it makes stored tokens unrecoverable), and DEVONE_ALLOW_BOOTSTRAP=true. You can also edit .env by hand.

docker compose pull fetches the latest release images. To stay on a version, set DEVONE_VERSION=0.1.0 in .env; to build from source instead, run docker compose up -d --build.

Open http://localhost:3000 and sign in with a GitHub or GitLab token: the first person to sign in becomes the administrator. Then set DEVONE_ALLOW_BOOTSTRAP=false in .env and run docker compose up -d again. New-user registration is disabled by default.

Use TLS in production so secure session cookies cannot travel over plaintext connections.

Prefer a managed host? The Deploy with Vercel button above creates your own copy; you'll need a PostgreSQL database (Neon works well) and an encryption key. See docs/deployment.md.

Roadmap

DevOne is young, and the direction is open to discussion. Things we'd like to do next:

• Published Docker images for every release
• A public demo instance
• More interface languages beyond English and Filipino
• Better mobile layouts across the workspace
• Notifications for mentions, assignments and failed pipelines

Have an idea or want to pick one up? Start a thread in Discussions or look for issues labelled good first issue.

Contributing

Contributions are welcome! Fork the repository, make your change on a branch in your fork, and open a pull request against main. CONTRIBUTING.md has the details. Questions are best asked in Discussions.

Found a security problem? Please report it privately; see SECURITY.md. Everyone taking part is expected to follow the code of conduct.

License

DevOne is released under the MIT License. It began from the MIT-licensed Next Shadcn Dashboard Starter.