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.
