diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3ce85e7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,173 @@
+# Bravo
+
+[![CI](https://github.com/leanucci/bravo/actions/workflows/ci.yml/badge.svg)](https://github.com/leanucci/bravo/actions/workflows/ci.yml)
+[![Gem Version](https://badge.fury.io/rb/bravo.svg)](https://badge.fury.io/rb/bravo)
+
+Ruby gem for Argentine electronic invoicing (facturación electrónica). Obtains CAE (Código de Autorización Electrónico) through AFIP's WSFE web service.
+
+## Requirements
+
+- Ruby 2.7+
+- Valid AFIP certificate and private key registered for WSFE service
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'bravo'
+```
+
+Or install directly:
+
+```bash
+gem install bravo
+```
+
+## Dependencies
+
+Bravo 2.0 uses [wsaa-ruby](https://github.com/leanucci/wsaa-ruby) for WSAA authentication. The gem handles certificate signing and token management automatically.
+
+## Configuration
+
+```ruby
+require 'bravo'
+
+Bravo.pkey = "/path/to/private_key"
+Bravo.cert = "/path/to/certificate.crt"
+Bravo.cuit = "20123456789"
+Bravo.sale_point = "0001"
+Bravo.own_iva_cond = :responsable_inscripto
+
+# Environment URLs
+Bravo.auth_url = "https://wsaahomo.afip.gov.ar/ws/services/LoginCms"      # Testing
+Bravo.service_url = "https://wswhomo.afip.gov.ar/wsfev1/service.asmx?WSDL" # Testing
+
+# For production, use:
+# Bravo.auth_url = "https://wsaa.afip.gov.ar/ws/services/LoginCms"
+# Bravo.service_url = "https://servicios1.afip.gov.ar/wsfev1/service.asmx?WSDL"
+
+# Defaults
+Bravo.default_documento = "CUIT"
+Bravo.default_concepto = "Productos y Servicios"
+Bravo.default_moneda = :peso
+```
+
+## Usage
+
+### Authorize an Invoice (FECAESolicitar)
+
+```ruby
+bill = Bravo::Bill.new(
+  net: 100.00,
+  iva_cond: :consumidor_final,
+  doc_num: "20123456789"
+)
+bill.aliciva_id = 5  # 21% IVA
+
+if bill.authorize
+  puts "CAE: #{bill.response.cae}"
+  puts "Due date: #{bill.response.cae_due_date}"
+else
+  puts "Error: #{bill.response.errors}"
+end
+```
+
+### Query Reference Data
+
+```ruby
+reference = Bravo::Reference.new
+
+# Invoice types
+reference.tipos_cbte
+# => [{id: 1, descripcion: "Factura A"}, ...]
+
+# Document types
+reference.tipos_doc
+# => [{id: 80, descripcion: "CUIT"}, ...]
+
+# IVA rates
+reference.alic_iva
+# => [{id: 5, descripcion: "21%"}, ...]
+
+# Currency types
+reference.tipos_monedas
+# => [{id: 1, descripcion: "Pesos Argentinos"}, ...]
+
+# Tax types (tributos)
+reference.tipos_tributos
+
+# Optional field types
+reference.tipos_opcional
+
+# Country types
+reference.tipos_paises
+
+# Sales points
+reference.ptos_venta
+# => [{nro: 1, emision_tipo: "CAE", bloqueado: "N", fch_baja: nil}, ...]
+
+# IVA receiver conditions
+reference.condicion_iva_receptor
+reference.condicion_iva_receptor("A")  # Filter by invoice class
+
+# Exchange rate
+reference.exchange_rate(:dolar)
+# => 350.50
+
+# Last authorized invoice number
+reference.ultimo_comprobante("01")
+# => 1234
+```
+
+### Query Authorized Invoices
+
+```ruby
+reference = Bravo::Reference.new
+
+# Query a specific invoice
+invoice = reference.consultar_comprobante("01", 1234)
+# => {cbte_tipo: 1, cbte_nro: 1234, cae: "12345678901234", ...}
+```
+
+### CAEA (Anticipated Authorization)
+
+```ruby
+reference = Bravo::Reference.new
+
+# Request CAEA for a period
+caea = reference.solicitar_caea("202608", 2)  # August 2026, second half
+# => {caea: "12345678901234", periodo: "202608", orden: 2, ...}
+
+# Query existing CAEA
+caea = reference.consultar_caea("202608", 2)
+```
+
+## Breaking Changes in 2.0
+
+- **Savon upgraded from 0.7.x to 2.0** - Internal change, but may affect code accessing `client` directly
+- **Authentication via wsaa-ruby** - No longer uses bash script; errors come from wsaa-ruby
+- **Authorizer class removed** - Was unused after refactor
+- **Ruby 2.7+ required** - Older versions no longer supported
+
+## Development
+
+```bash
+bundle install
+CUIT=20123456789 bundle exec rspec
+```
+
+To record new VCR cassettes:
+
+```bash
+CUIT=20123456789 VCR_RECORD=1 bundle exec rspec
+```
+
+## License
+
+MIT License. See [LICENSE.txt](LICENSE.txt).
+
+## Credits
+
+- Leandro Marcucci
+- Emilio Tagua (contributions and advice)
diff --git a/README.textile b/README.textile
deleted file mode 100644
index 53385a1..0000000
--- a/README.textile
+++ /dev/null
@@ -1,53 +0,0 @@
-h1. Bravo: la gema de facturación electrónica argentina
-
-"-Bravo-":http://images.coveralia.com/audio/b/Bravo-Desierto_Sin_Amor-Frontal.jpg Bravo permite la obtención del "-C.A.E.-":http://www.muevamueva.com/masmusica/latina/cae/images/fotos.5.gif C.A.E. (Código de Autorización Electrónico) por medio del Web Service de Facturación Electrónica provisto por la AFIP.
-
-h2. Instalación
-
-<pre>
-  gem install bravo
-</pre>
-
-o
-
-<pre>
-  gem 'bravo'
-</pre>
-
-en tu @Gemfile@
-
-
-h2. Configuraci&oacute;n
-
-Los servicios de AFIP requieren la utilizaci&oacute;n del Web Service de Autorizaci&oacute;n y Autenticaci&oacute;n ("wsaa readme":http://www.afip.gov.ar/ws/WSAA/README.txt)
-
-Luego de cumplidos los pasos indicados en el readme, basta con configurar Bravo con la ruta a los archivos:
-
-<pre>
-  Bravo.pkey = "spec/fixtures/pkey"
-  Bravo.cert = "spec/fixtures/cert.crt"
-</pre>
-
-y exportar la variable CUIT con el n&uacute;mero de cuit usado para obtener los certificados:
-
-@export CUIT=_numerodecuit_@
-
-Bravo acepta m&aacute;s opciones, para m&aacute;s detalles ver el "spec_helper":https://github.com/vurbia/Bravo/blob/master/spec/spec_helper.rb
-
-h2. Uso
-
-El uso de la gema se centra en el metodo @authorize@. Este m&eacute;todo invoca @FECAESolicitar@ y devuelve el resultado, que de ser exitoso incluye el CAE y su fecha de vencimento (ver "bill_spec":https://github.com/vurbia/Bravo/blob/master/spec/bravo/bill_spec.rb#L87)
-
-
-h2. TODO list
-
-* rdoc
-* mensajes de error m&aacute;s completos
-
-
-
-h2. Agradecimientos
-
-* Emilio Tagua por sus consejos y contribuciones.
-
-Copyright (c) 2010 Leandro Marcucci  & Vurbia Technologies International Inc. See LICENSE.txt for further details.
diff --git a/bravo.gemspec b/bravo.gemspec
index 03b3ba1..46a34c6 100644
--- a/bravo.gemspec
+++ b/bravo.gemspec
@@ -13,7 +13,7 @@ Gem::Specification.new do |s|
 
   s.required_ruby_version = ">= 2.7.0"
 
-  s.files = Dir.glob("{lib}/**/*") + %w[LICENSE.txt README.textile CHANGELOG VERSION]
+  s.files = Dir.glob("{lib}/**/*") + %w[LICENSE.txt README.md CHANGELOG VERSION]
   s.require_paths = ["lib"]
 
   s.add_dependency "savon", "~> 2.0"